Email Providers

Create a new email provider

post/email-providers

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/email-providers
  • Auth: HTTP bearer

Request body

namestring required

User-friendly name for the provider

provider_type'ses' | 'scaleway' | 'smtp' required
regionstring required

Cloud region. For SMTP this is informational only — the host/port carry the real routing.

sns_topic_arnstring nullable

Exact SNS topic allowed to deliver SES events for this provider.

Example request

{
  "name": "My AWS SES",
  "region": "us-east-1",
  "scaleway_credentials": {
    "api_key": "scw-secret-key-12345",
    "project_id": "12345678-1234-1234-1234-123456789012"
  },
  "ses_credentials": {
    "access_key_id": "AKIAIOSFODNN7EXAMPLE",
    "secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
  },
  "smtp_credentials": {
    "host": "email-smtp.eu-west-1.amazonaws.com",
    "port": 587,
    "username": "AKIAIOSFODNN7EXAMPLE"
  }
}

Response

Provider created successfully

created_atstring required
credentialsunknown required
idinteger required
is_activeboolean required
namestring required
provider_type'ses' | 'scaleway' | 'smtp' required
regionstring required
sns_topic_arnstring nullable
updated_atstring required

Example response

{
  "created_at": "2025-12-03T10:30:00Z",
  "name": "My AWS SES",
  "region": "us-east-1",
  "updated_at": "2025-12-03T10:30:00Z"
}

Changes

No recorded changes to this operation across all 53 revisions of this API.