Skip to main content
POST
/
action-configurations
Create Action Configuration
curl --request POST \
  --url https://api.authsignal.com/v1/management/action-configurations \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "actionCode": "<string>",
  "defaultUserActionResult": "ALLOW",
  "messagingTemplates": {},
  "verificationMethods": [
    "SMS"
  ],
  "promptToEnrollVerificationMethods": [
    "PASSKEY"
  ],
  "defaultVerificationMethod": "SMS",
  "postVerificationWebhookUrl": "<string>"
}
'
{
  "lastActionCreatedAt": "<string>",
  "actionCode": "<string>",
  "tenantId": "<string>",
  "defaultUserActionResult": "ALLOW",
  "messagingTemplates": {},
  "verificationMethods": [
    "SMS"
  ],
  "promptToEnrollVerificationMethods": [
    "PASSKEY"
  ],
  "defaultVerificationMethod": "SMS",
  "postVerificationWebhookUrl": "<string>"
}

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
​
actionCode
string
required
​
defaultUserActionResult
enum<string>
required
Available options:
ALLOW,
BLOCK,
CHALLENGE,
REVIEW
​
messagingTemplates
object
​
verificationMethods
enum<string>[]
Minimum array length: 1
Available options:
SMS,
AUTHENTICATOR_APP,
RECOVERY_CODE,
EMAIL_MAGIC_LINK,
EMAIL_OTP,
PUSH,
DEVICE,
SECURITY_KEY,
PASSKEY,
VERIFF,
IPROOV,
PALM_BIOMETRICS_RR
​
promptToEnrollVerificationMethods
enum<string>[]
Minimum array length: 1
Available options:
PASSKEY
​
defaultVerificationMethod
enum<string>
Available options:
SMS,
AUTHENTICATOR_APP,
RECOVERY_CODE,
EMAIL_MAGIC_LINK,
EMAIL_OTP,
PUSH,
DEVICE,
SECURITY_KEY,
PASSKEY,
VERIFF,
IPROOV,
PALM_BIOMETRICS_RR
​
postVerificationWebhookUrl
string<uri>

Webhook URL to receive best-effort action.updated events when this action succeeds, fails or is blocked.

Response

OK

​
lastActionCreatedAt
string
​
actionCode
string
​
tenantId
string
​
defaultUserActionResult
enum<string>
Available options:
ALLOW,
BLOCK,
CHALLENGE,
REVIEW
​
messagingTemplates
object
​
verificationMethods
enum<string>[]
Minimum array length: 1
Available options:
SMS,
AUTHENTICATOR_APP,
RECOVERY_CODE,
EMAIL_MAGIC_LINK,
EMAIL_OTP,
PUSH,
DEVICE,
SECURITY_KEY,
PASSKEY,
VERIFF,
IPROOV,
PALM_BIOMETRICS_RR
​
promptToEnrollVerificationMethods
enum<string>[]
Minimum array length: 1
Available options:
PASSKEY
​
defaultVerificationMethod
enum<string>
Available options:
SMS,
AUTHENTICATOR_APP,
RECOVERY_CODE,
EMAIL_MAGIC_LINK,
EMAIL_OTP,
PUSH,
DEVICE,
SECURITY_KEY,
PASSKEY,
VERIFF,
IPROOV,
PALM_BIOMETRICS_RR
​
postVerificationWebhookUrl
string<uri>

Webhook URL to receive best-effort action.updated events when this action succeeds, fails or is blocked.