Skip to main content
PATCH
Update the email OTP configuration

Authorizations

Authorization
string
header
required

Use your Authsignal Management API secret key as the username and leave the password empty. This key is different from the Server API key and can be found in the API Keys section of the Authsignal Portal settings page.

Body

application/json

Email OTP fields to update. Omitted fields are preserved. Send null for a clearable field to remove it. Credential objects are merged with stored credentials. When emailProvider changes, the new provider's credentials are required unless a complete set is already stored; restating the current provider needs none. Credentials must belong to the selected (or stored) provider, and a request that leaves it without complete credentials is rejected.

isActive
boolean
emailProvider
enum<string>

The email provider. Supply the matching credential object for BIRD, MAILJET, MAILGUN, MANDRILL, SENDGRID, or SMTP.

Available options:
BIRD,
MAILJET,
MAILGUN,
MANDRILL,
SENDGRID,
SMTP
submissionRateLimitConfiguration
object | null
sendingRateLimitConfigurations
object[] | null

Message delivery limits. Every configured limit applies.

Required array length: 1 - 6 elements
allowedCustomEmailVariables
string[]
mailjetEmailCredentials
object | null

Use with the MAILJET email provider.

mailgunEmailCredentials
object | null

Use with the MAILGUN email provider.

mandrillEmailCredentials
object | null

Use with the MANDRILL email provider.

birdEmailCredentials
object | null

Use with the BIRD email provider.

sendgridEmailCredentials
object | null

Use with the SENDGRID email provider.

smtpEmailCredentials
object | null

Use with the SMTP email provider.

Response

OK

authenticatorId
string
required
read-only

The immutable identifier for this configuration.

isActive
boolean
required
verificationMethod
string
required
read-only

The verification method produced by this configuration.

Allowed value: "EMAIL_OTP"
emailProvider
enum<string>

The email provider. Supply the matching credential object for BIRD, MAILJET, MAILGUN, MANDRILL, SENDGRID, or SMTP.

Available options:
BIRD,
MAILJET,
MAILGUN,
MANDRILL,
SENDGRID,
SMTP
submissionRateLimitConfiguration
object
sendingRateLimitConfigurations
object[]

Message delivery limits. Every configured limit applies.

Required array length: 1 - 6 elements
allowedCustomEmailVariables
string[]
mailjetEmailCredentials
object

Use with the MAILJET email provider.

mailgunEmailCredentials
object

Use with the MAILGUN email provider.

mandrillEmailCredentials
object

Use with the MANDRILL email provider.

birdEmailCredentials
object

Use with the BIRD email provider.

sendgridEmailCredentials
object

Use with the SENDGRID email provider.

smtpEmailCredentials
object

Use with the SMTP email provider.