How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

SendGrid Domain Authentication API

Twilio SendGrid Domain Authentication API

SendGrid Domain Authentication API is one of 63 APIs that SendGrid publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Domain Authentication. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 16 operations across 11 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.sendgrid.com, https://api.eu.sendgrid.com.

16 operations 11 paths 2 schemas 4 DELETE5 GET1 PATCH6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.sendgrid.com
Authentication
HTTP Bearer
License
Terms of Service
Resource Areas
1

Authentication & Security 1

SendGrid Domain Authentication API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Twilio SendGrid requires you to authenticate with its APIs using an API key. The API key must be sent as a bearer token in the Authorization header.

Paths & Operations 16

Across 11 paths, the API surfaces 16 operations — 4 DELETE, 5 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Domain Authentication 16

Twilio SendGrid Domain Authentication API

POST
/v3/whitelabel/dns/email
Email DNS records to a co-worker
EmailDnsRecord body → 204400
GET
/v3/whitelabel/domains
List all authenticated domains
ListAuthenticatedDomain 6 params → 200
POST
/v3/whitelabel/domains
Authenticate a domain
AuthenticateDomain 1 param body → 201
GET
/v3/whitelabel/domains/{domain_id}
Retrieve an authenticated domain
GetAuthenticatedDomain 2 params → 200
PATCH
/v3/whitelabel/domains/{domain_id}
Update an authenticated domain
UpdateAuthenticatedDomain 2 params body → 200
DELETE
/v3/whitelabel/domains/{domain_id}
Delete an authenticated domain.
DeleteAuthenticatedDomain 2 params → 204
POST
/v3/whitelabel/domains/{domain_id}/subuser
Associate an authenticated domain with a given user.
AssociateSubuserWithDomain 1 param body → 201
DELETE
/v3/whitelabel/domains/{domain_id}/subuser
Disassociate an authenticated domain from a given user for users with up to five associated domains.
DisassociateSubuserFromDomain 2 params → 204
POST
/v3/whitelabel/domains/{domain_id}/subuser:add
Associate an authenticated domain with a given user, for up to five domains.
AssociateSubuserWithDomainMultiple 1 param body → 201
POST
/v3/whitelabel/domains/{id}/ips
Add an IP to an authenticated domain
AddIpToAuthenticatedDomain 2 params body → 200
DELETE
/v3/whitelabel/domains/{id}/ips/{ip}
Remove an IP from an authenticated domain.
DeleteIpFromAuthenticatedDomain 3 params → 200
POST
/v3/whitelabel/domains/{id}/validate
Validate a domain authentication.
ValidateAuthenticatedDomain 2 params → 200500
GET
/v3/whitelabel/domains/default
Get the default authentication
ListDefaultAuthenticatedDomain 2 params → 200
GET
/v3/whitelabel/domains/subuser
List the authenticated domain associated with the given user.
ListAuthenticatedDomainWithUser 1 param → 200
DELETE
/v3/whitelabel/domains/subuser
Disassociate an authenticated domain from a given user.
DisassociateAuthenticatedDomainFromUser 1 param → 204
GET
/v3/whitelabel/domains/subuser/all
List all the authenticated domains associated with the given user.
ListAllAuthenticatedDomainWithUser 1 param → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are AuthenticatedDomainSpf (12 properties), AuthenticatedDomain (12 properties). Each schema is shown below with its type and property counts.

AuthenticatedDomain
object
12 properties 12 required
AuthenticatedDomainSpf
object
12 properties 11 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

sendgrid-domain-authentication-api-openapi.yml Raw ↑

Other APIs SendGrid publishes across the network.

SendGrid Account API
SendGrid Account State API
SendGrid Alerts API
SendGrid API Keys API
SendGrid Blocks API
SendGrid Bounces API
SendGrid Bulk Email Address Validation API
SendGrid Campaigns API API
SendGrid Categories API
SendGrid Contacts API
SendGrid Custom Fields API
SendGrid Designs API
Where this information came from

This is an independent, third-party profile of SendGrid Domain Authentication API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.