CHchariot-giving
Event Subscriptions

Create an Event Subscription

Changed on

Create an event subscription corresponding to your Chariot account.

post/v1/event_subscriptions

Request

  • Base URL
    https://sandboxapi.givechariot.com
  • URL
    https://sandboxapi.givechariot.com/v1/event_subscriptions
  • Auth
    HTTP bearer

Request body

urlstring required

The webhook url where we'll send notifications.

category'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' | 'donor_account.created' | 'donor_account.updated' | 'authorization_token.created' | 'authorization_token.updated' | 'grant_request.created' | 'grant_request.updated' | 'disbursement.created' | 'disbursement.updated' | 'inbound_transfer.created' | 'inbound_transfer.updated' | 'donation.created' | 'donation.updated' | 'donation.deleted' | 'deposit.created' | 'deposit.updated' | 'verification_request.created' | 'verification_request.updated' | 'connection.revoked' required

The category of the event. This is useful for filtering events.

Event names follow the pattern {resource}.{event_type} where event_type is usually created or updated. Status transitions (for example, a Donor Account moving to approved or rejected) are emitted as {resource}.updated events — fetch the object to read its current status.

signing_secretstring

The key that will be used to sign webhooks. If no value is passed, a random string will be used as default. This is necessary to verify that the webhook is coming from Chariot. While this parameter is optional, it is highly recommended to pass a value for the secret and implement webhook signature verification.

Example request

{
  "url": "https://example.com/webhook"
}

Response

Created

idstring

The unique identifier for the event subscription

created_atstring date-time

The date and time the event subscription was created

status'active' | 'disabled' | 'deleted' | 'requires_attention'

The status of the event subscription. This indicates if we'll send notifications to this subscription

  • active: subscription is active and events will be delivered normally
  • disabled: subscription is temporarily disabled and events will not be delivered
  • deleted: subscription has been deleted and events will not be delivered
  • requires_attention: subscription has been disabled due to delivery failures and events will not be delivered
urlstring required

The webhook url where we'll send notifications.

category'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' | 'donor_account.created' | 'donor_account.updated' | 'authorization_token.created' | 'authorization_token.updated' | 'grant_request.created' | 'grant_request.updated' | 'disbursement.created' | 'disbursement.updated' | 'inbound_transfer.created' | 'inbound_transfer.updated' | 'donation.created' | 'donation.updated' | 'donation.deleted' | 'deposit.created' | 'deposit.updated' | 'verification_request.created' | 'verification_request.updated' | 'connection.revoked'

The category of the event. This is useful for filtering events.

Event names follow the pattern {resource}.{event_type} where event_type is usually created or updated. Status transitions (for example, a Donor Account moving to approved or rejected) are emitted as {resource}.updated events — fetch the object to read its current status.

Example response

{
  "id": "4d06d393-1f14-46cf-b02d-8db17d7ed06a",
  "created_at": "2024-01-14T12:48:56.37Z",
  "url": "https://example.com/webhook"
}

Changes

  • 2026-10-01d2a4ff2fdda5Revision changes
    • warning

      added the new donation.deleted enum value to the response property for the response status

    • info

      added the new donation.deleted enum value to the request property

  • 2026-10-0123145538add0Revision changes
    • warning

      added the new connection.revoked enum value to the response property for the response status

    • info

      added the new connection.revoked enum value to the request property