Encharge Email Domain Settings API
The email settings API from Encharge — 5 operation(s) for adding and verifying sending domains.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/encharge-settings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
version: 1.0.0
title: Encharge Settings API
description: The Encharge.io API
license:
name: MIT
contact:
url: https://help.encharge.io
name: unknown
servers:
- url: https://api.encharge.io/v1
tags:
- name: Settings
paths:
/settings/email/domains:
get:
operationId: GetDomains
responses:
'200':
description: Ok
content:
application/json:
schema:
properties:
domains:
items:
$ref: '#/components/schemas/EmailDomainResponse'
type: array
required:
- domains
type: object
description: List all email domains for the account.
security:
- oauth2: []
parameters: []
tags:
- Settings
post:
operationId: CreateDomain
responses:
'200':
description: Created
content:
application/json:
schema:
properties:
domain:
$ref: '#/components/schemas/EmailDomainResponse'
required:
- domain
type: object
description: 'Add an email domain for verification.
Starts the domain verification process; DNS records must be added to complete verification.'
security:
- oauth2:
- emailSettings:write
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/EmailDomainCreateBody'
tags:
- Settings
/settings/email/domains/{id}:
get:
operationId: GetDomain
responses:
'200':
description: Ok
content:
application/json:
schema:
properties:
domain:
$ref: '#/components/schemas/EmailDomainResponse'
required:
- domain
type: object
description: Get a single email domain by ID.
security:
- oauth2: []
parameters:
- in: path
name: id
required: true
schema:
format: double
type: number
tags:
- Settings
delete:
operationId: DeleteDomain
responses:
'204':
description: No Content
description: Remove an email domain and its verification.
security:
- oauth2:
- emailSettings:write
parameters:
- in: path
name: id
required: true
schema:
format: double
type: number
tags:
- Settings
/settings/email/domains/{id}/verify:
post:
operationId: VerifyDomain
responses:
'200':
description: Ok
content:
application/json:
schema:
properties:
domain:
$ref: '#/components/schemas/EmailDomainResponse'
required:
- domain
type: object
description: 'Trigger verification check for an email domain.
Re-checks DNS records and updates verification status.'
security:
- oauth2:
- emailSettings:write
parameters:
- in: path
name: id
required: true
schema:
format: double
type: number
tags:
- Settings
components:
schemas:
EmailDomainResponse:
description: Email domain (verification status and DNS records).
properties:
id:
type: number
format: double
domain:
type: string
status:
type: string
dns:
items:
$ref: '#/components/schemas/EmailDomainDNSRecordResponse'
type: array
accountId:
type: number
format: double
isSES:
type: boolean
error:
type: string
hasRestrictiveSubdomainPolicy:
type: boolean
externalIds:
properties:
sendgridAccountName:
type: string
sendgridDomainAuthentication:
type: number
format: double
type: object
dnsRecordsExpiredAt:
type:
- string
- 'null'
dnsRecordsExpiredCount:
type: number
format: double
dontRecheckDNSRecords:
type: boolean
required:
- id
- domain
- status
- dns
- accountId
type: object
additionalProperties: false
EmailDomainCreateBody:
description: Request body for adding an email domain for verification.
properties:
domain:
type: string
description: Domain name to verify (e.g. example.com)
required:
- domain
type: object
additionalProperties: false
EmailDomainDNSRecordResponse:
description: DNS record for domain verification.
properties:
type:
type: string
enum:
- CNAME
- TXT
host:
type: string
data:
type: string
valid:
type: boolean
reason:
type: string
optional:
type: boolean
required:
- type
- host
- data
- valid
type: object
additionalProperties: false
securitySchemes:
apiKeyHeader:
description: "You can use API key authentication if you are using the API for your Encharge account. If you are building an app for others to use, please use the OAuth2 authentication below. Find your API key from https://app.encharge.io/account/info . \n\n While all operations in the API specify oauth2 security, instead you can use an API key in the header or query string."
type: apiKey
in: header
name: X-Encharge-Token
apiKeyQuery:
description: "You can use API key authentication if you are using the API for your Encharge account. \n\nIf you are building an app for others to use, please use the OAuth2 authentication below. Find your API key from https://app.encharge.io/account/info \n\n While all operations in the API specify oauth2 security, instead you can use an API key in the header or query string."
type: apiKey
in: query
name: token
oauth2:
type: oauth2
description: "The Encharge API uses OAuth 2 with the authorization code flow. \n\nGet for your OAuth credentials (Client ID and Client Secret) by filling out [this form](https://research.typeform.com/to/I680YtLA)."
flows:
authorizationCode:
authorizationUrl: https://api.encharge.io/v1/oauth/authorize
tokenUrl: https://api.encharge.io/v1/oauth/token
refreshUrl: https://api.encharge.io/v1/oauth/token
scopes: {}