PUT
/
account
/
{accountId}
/
authorization-webhook
cURL
curl --request PUT \
  --url https://api.joinslash.com/account/{accountId}/authorization-webhook \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "webhookUrl": "<string>",
  "status": "active",
  "config": {
    "fallbackBehavior": "default"
  }
}'
{
  "webhookUrl": "<string>",
  "signingSecret": "<string>",
  "status": "active",
  "timeoutDurationMs": 123,
  "config": {
    "fallbackBehavior": "default"
  },
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}
Enterprise Feature: Authorization webhooks are an enterprise-only feature. Please reach out to sales@slash.com to get set up with this functionality.
The Authorization Request Event schema shows the shape of the event that is sent to the webhook.

Authorizations

​
X-API-Key
string
header
required

Authentication from public API requests

Path Parameters

​
accountId
string
required

Body

application/json
​
webhookUrl
string
required

The URL where authorization webhook events will be sent

​
status
enum<string>
required

Current status of the webhook

Available options:
active,
inactive
​
config
object
required

Configuration specific to the authorization webhook

Response

Authorization webhook created or updated successfully

​
webhookUrl
string
required

The URL where authorization webhook events will be sent

​
signingSecret
string
required

Secret used for signing webhook payloads

​
status
enum<string>
required

Current status of the webhook

Available options:
active,
inactive
​
timeoutDurationMs
integer
required

The timeout duration in milliseconds for webhook requests

​
config
object
required

Configuration specific to the authorization webhook

​
createdAt
string<date-time>
required

When the webhook was created

​
updatedAt
string<date-time>
required

When the webhook was last updated