v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Providers API

Create a Provider

Use this endpoint to register a new communication provider (email or SMS) for use in authentication and notification flows.

post/v1/providers

Request body

namestring required

A unique name to identify the provider.

category'Email' | 'SMS' required

The provider category.

type'SendGrid' | 'Twilio' required

The provider implementation type.

subTypestring

Provider sub-type, if applicable.

methodstring

Authentication or delivery method.

clientIdstring

Client ID or API key for authenticating with the provider.

clientSecretstring

Client secret or API secret for authenticating with the provider.

clientId2string

Secondary client ID, if applicable.

clientSecret2string

Secondary client secret, if applicable.

hoststring

SMTP or API host address (Email providers).

portinteger

SMTP port (Email providers).

disableSslboolean

Set to true to disable SSL/TLS (not recommended for production).

titlestring

Default email or SMS title/subject.

contentstring

Default message content template.

receiverstring

Default receiver address for testing.

regionIdstring

Cloud region ID (provider-specific).

signNamestring

SMS signature name (provider-specific).

templateCodestring

SMS template code (provider-specific).

appIdstring

Application ID (provider-specific).

endpointstring

Provider API endpoint URL.

intranetEndpointstring

Intranet endpoint for private network access.

domainstring

Provider domain.

Response

Indicates that the provider was successfully created and the operation was completed as expected.

idstring

Unique identifier of the provider.

namestring

Name of the provider.

category'Email' | 'SMS'

Provider category.

type'SendGrid' | 'Twilio'

Provider implementation type.

subTypestring

Provider sub-type, if applicable.

methodstring

Authentication or delivery method.

clientIdstring

Client ID or API key (secret is never returned).

clientId2string

Secondary client ID, if applicable.

hoststring

SMTP or API host address.

portinteger

SMTP port.

disableSslboolean

Indicates whether SSL/TLS is disabled.

titlestring

Default email or SMS title/subject.

contentstring

Default message content template.

receiverstring

Default receiver address for testing.

regionIdstring

Cloud region ID (provider-specific).

signNamestring

SMS signature name (provider-specific).

templateCodestring

SMS template code (provider-specific).

appIdstring

Application ID (provider-specific).

endpointstring

Provider API endpoint URL.

intranetEndpointstring

Intranet endpoint for private network access.

domainstring

Provider domain.

providerUrlstring

Provider-specific URL.

createdAtstring date-time

Timestamp marking when the provider was created.