Get all webhooks
Retrieve the list of created webhooks. Requires the webhook:view role on the API key.
Responses
webhook_idstring · uuid · readOnly · requiredThe id of the webhook.
namestring · requiredThe name of the webhook.
urlstring · · requiredThe endpoint that you want us to send events to.
activeboolean · requiredThis value controls whether the webhook will have events sent to it, or not.
eventsstring[] · minItems: 1 · unique · requiredThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferralfilterobjectFilter events by certain criteria.
Create new webhook
Create a webhook to recieve certain events from us. For a comprehensive list of possible events that you could subscribe to see event types. Requires the webhook:create role on the API key.
Request Body
namestring · requiredThe name of the webhook.
urlstring · · requiredThe endpoint that you want us to send events to.
eventsstring[] · minItems: 1 · unique · requiredThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferral
activebooleanThis value controls whether the webhook will have events sent to it, or not.
filterobjectFilter events by certain criteria.
Responses
webhook_idstring · uuid · readOnly · requiredThe id of the webhook.
namestring · requiredThe name of the webhook.
urlstring · · requiredThe endpoint that you want us to send events to.
activeboolean · requiredThis value controls whether the webhook will have events sent to it, or not.
eventsstring[] · minItems: 1 · unique · requiredThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferralfilterobjectFilter events by certain criteria.
Get one webhook
Get all of the details of a certain webhook, including name, url, if it's active, and the events it is subscribed to. Requires the webhook:view role on the API key.
path Parameters
idstring · uuid · requiredThe id of the webhook.
Responses
webhook_idstring · uuid · readOnly · requiredThe id of the webhook.
namestring · requiredThe name of the webhook.
urlstring · · requiredThe endpoint that you want us to send events to.
activeboolean · requiredThis value controls whether the webhook will have events sent to it, or not.
eventsstring[] · minItems: 1 · unique · requiredThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferralfilterobjectFilter events by certain criteria.
Update a webhook
Update the webhook by putting any of the changed values. They will update the webhook to the new values and keep the rest the same. Requires the webhook:update role on the API key.
path Parameters
idstring · uuid · requiredThe id of the webhook.
Request Body
namestringThe name of the webhook.
urlstring ·The endpoint that you want us to send events to.
activebooleanThis value controls whether the webhook will have events sent to it, or not.
eventsstring[] · minItems: 1 · uniqueThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferralfilterobjectFilter events by certain criteria.
Responses
webhook_idstring · uuid · readOnly · requiredThe id of the webhook.
namestring · requiredThe name of the webhook.
urlstring · · requiredThe endpoint that you want us to send events to.
activeboolean · requiredThis value controls whether the webhook will have events sent to it, or not.
eventsstring[] · minItems: 1 · unique · requiredThe list of events you want us to send to your endpoint.
Enum values:NewSignupNewReferralfilterobjectFilter events by certain criteria.
