Skip to content

WebhooksPaths

Defined in: src/webhooks/types.gen.ts:2

/v1/webhooks: object

Defined in: src/webhooks/types.gen.ts:3

optional delete?: undefined

get: object

List Webhooks

List the webhooks you have registered

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: object

optional cursor?: string | null

optional limit?: number | null

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.items
Section titled “get.responses.200.content.application/json.items”

items: object[]

get.responses.200.content.application/json.next_cursor?
Section titled “get.responses.200.content.application/json.next_cursor?”

optional next_cursor?: string | null

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

post: object

Register Webhook

Register an endpoint to start receiving selected webhook events

parameters: object

optional cookie?: undefined

header: object

Idempotency-Key: string

optional path?: undefined

optional query?: undefined

requestBody: object

content: object

application/json: object

post.requestBody.content.application/json.event_types
Section titled “post.requestBody.content.application/json.event_types”

event_types: ("REFERRAL_CREATED" | "REFERRAL_ACTIVATED" | "REFERRAL_APPLICATION_STATUS_CHANGED" | "TRANSFER_PROCESSED" | "TRANSFER_FAILED" | "EXPENSE_PAYMENT_UPDATED" | "USER_UPDATED" | "EMBEDDED_CARD_TRANSACTION_UPDATED" | "EMBEDDED_CARD_UPDATED" | "EMBEDDED_ACCOUNT_UPDATED" | "EMBEDDED_CARD_SHIPPING_UPDATED" | "EMBEDDED_DISPUTE_UPDATED" | "PARTNERSHIP_INTEGRATION_CONNECTION_UPDATED" | "EMBEDDED_CARD_AUTHORIZATION" | "EMBEDDED_FRAUD_ALERT" | "EMBEDDED_BILLING_GROUP_UPDATED" | "EMBEDDED_LEGAL_ENTITY_UPDATED" | "EMBEDDED_BILLING_STATEMENT_UPDATED" | "EMBEDDED_USER_STATUS_UPDATED" | "ACCOUNTING_RECORD_READY_FOR_EXPORT")[]

A list of the webhook event types this subscription will listen to.

post.requestBody.content.application/json.group_id?
Section titled “post.requestBody.content.application/json.group_id?”

optional group_id?: string | null

ID of the webhook group to which this subscription applies, if any. This is only available for partners.

wg_123
post.requestBody.content.application/json.url
Section titled “post.requestBody.content.application/json.url”

url: string

The URL to which webhook events will be sent. Must be a valid HTTPS URL.

https://example.com/webhook

responses: object

200: object

Success

content: object

post.responses.200.content.application/json
Section titled “post.responses.200.content.application/json”

application/json: object

post.responses.200.content.application/json.event_types
Section titled “post.responses.200.content.application/json.event_types”

event_types: ("REFERRAL_CREATED" | "REFERRAL_ACTIVATED" | "REFERRAL_APPLICATION_STATUS_CHANGED" | "TRANSFER_PROCESSED" | "TRANSFER_FAILED" | "EXPENSE_PAYMENT_UPDATED" | "USER_UPDATED" | "EMBEDDED_CARD_TRANSACTION_UPDATED" | "EMBEDDED_CARD_UPDATED" | "EMBEDDED_ACCOUNT_UPDATED" | "EMBEDDED_CARD_SHIPPING_UPDATED" | "EMBEDDED_DISPUTE_UPDATED" | "PARTNERSHIP_INTEGRATION_CONNECTION_UPDATED" | "EMBEDDED_CARD_AUTHORIZATION" | "EMBEDDED_FRAUD_ALERT" | "EMBEDDED_BILLING_GROUP_UPDATED" | "EMBEDDED_LEGAL_ENTITY_UPDATED" | "EMBEDDED_BILLING_STATEMENT_UPDATED" | "EMBEDDED_USER_STATUS_UPDATED" | "ACCOUNTING_RECORD_READY_FOR_EXPORT")[]

List of event types that this webhook subscription listens to.

["EXPENSE_PAYMENT_UPDATED"]
post.responses.200.content.application/json.group_id?
Section titled “post.responses.200.content.application/json.group_id?”

optional group_id?: string | null

ID of the webhook group to which this subscription applies, if any.

wg_123
post.responses.200.content.application/json.id
Section titled “post.responses.200.content.application/json.id”

id: string

ID of the webhook subscription.

wsub_123
post.responses.200.content.application/json.status
Section titled “post.responses.200.content.application/json.status”

status: "ACTIVE" | "INACTIVE"

post.responses.200.content.application/json.url
Section titled “post.responses.200.content.application/json.url”

url: string

The URL to which webhook events will be sent. Must be a valid HTTPS URL.

https://example.com/webhook

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional put?: undefined

optional trace?: undefined


/v1/webhooks/{id}: object

Defined in: src/webhooks/types.gen.ts:27

delete: object

Unregister Webhook

Unregister a webhook if you want to stop receiving webhook events

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

Success

optional content?: undefined

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

get: object

Get Webhook

Get details of a webhook

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.event_types
Section titled “get.responses.200.content.application/json.event_types”

event_types: ("REFERRAL_CREATED" | "REFERRAL_ACTIVATED" | "REFERRAL_APPLICATION_STATUS_CHANGED" | "TRANSFER_PROCESSED" | "TRANSFER_FAILED" | "EXPENSE_PAYMENT_UPDATED" | "USER_UPDATED" | "EMBEDDED_CARD_TRANSACTION_UPDATED" | "EMBEDDED_CARD_UPDATED" | "EMBEDDED_ACCOUNT_UPDATED" | "EMBEDDED_CARD_SHIPPING_UPDATED" | "EMBEDDED_DISPUTE_UPDATED" | "PARTNERSHIP_INTEGRATION_CONNECTION_UPDATED" | "EMBEDDED_CARD_AUTHORIZATION" | "EMBEDDED_FRAUD_ALERT" | "EMBEDDED_BILLING_GROUP_UPDATED" | "EMBEDDED_LEGAL_ENTITY_UPDATED" | "EMBEDDED_BILLING_STATEMENT_UPDATED" | "EMBEDDED_USER_STATUS_UPDATED" | "ACCOUNTING_RECORD_READY_FOR_EXPORT")[]

List of event types that this webhook subscription listens to.

["EXPENSE_PAYMENT_UPDATED"]
get.responses.200.content.application/json.group_id?
Section titled “get.responses.200.content.application/json.group_id?”

optional group_id?: string | null

ID of the webhook group to which this subscription applies, if any.

wg_123
get.responses.200.content.application/json.id
Section titled “get.responses.200.content.application/json.id”

id: string

ID of the webhook subscription.

wsub_123
get.responses.200.content.application/json.status
Section titled “get.responses.200.content.application/json.status”

status: "ACTIVE" | "INACTIVE"

get.responses.200.content.application/json.url
Section titled “get.responses.200.content.application/json.url”

url: string

The URL to which webhook events will be sent. Must be a valid HTTPS URL.

https://example.com/webhook

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

put: object

Update Webhook

Update a webhook. You can update the endpoint url, event types that the endpoint receives, or temporarily deactivate the webhook.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

optional query?: undefined

requestBody: object

content: object

application/json: object

put.requestBody.content.application/json.event_types
Section titled “put.requestBody.content.application/json.event_types”

event_types: ("REFERRAL_CREATED" | "REFERRAL_ACTIVATED" | "REFERRAL_APPLICATION_STATUS_CHANGED" | "TRANSFER_PROCESSED" | "TRANSFER_FAILED" | "EXPENSE_PAYMENT_UPDATED" | "USER_UPDATED" | "EMBEDDED_CARD_TRANSACTION_UPDATED" | "EMBEDDED_CARD_UPDATED" | "EMBEDDED_ACCOUNT_UPDATED" | "EMBEDDED_CARD_SHIPPING_UPDATED" | "EMBEDDED_DISPUTE_UPDATED" | "PARTNERSHIP_INTEGRATION_CONNECTION_UPDATED" | "EMBEDDED_CARD_AUTHORIZATION" | "EMBEDDED_FRAUD_ALERT" | "EMBEDDED_BILLING_GROUP_UPDATED" | "EMBEDDED_LEGAL_ENTITY_UPDATED" | "EMBEDDED_BILLING_STATEMENT_UPDATED" | "EMBEDDED_USER_STATUS_UPDATED" | "ACCOUNTING_RECORD_READY_FOR_EXPORT")[]

A list of the webhook event types this subscription will listen to.

put.requestBody.content.application/json.group_id?
Section titled “put.requestBody.content.application/json.group_id?”

optional group_id?: string | null

ID of the webhook group to which this subscription applies, if any. This is only available for partners.

wg_123
put.requestBody.content.application/json.status
Section titled “put.requestBody.content.application/json.status”

status: "ACTIVE" | "INACTIVE"

put.requestBody.content.application/json.url
Section titled “put.requestBody.content.application/json.url”

url: string

The URL to which webhook events will be sent. Must be a valid HTTPS URL.

https://example.com/webhook

responses: object

200: object

Success

content: object

put.responses.200.content.application/json
Section titled “put.responses.200.content.application/json”

application/json: object

put.responses.200.content.application/json.event_types
Section titled “put.responses.200.content.application/json.event_types”

event_types: ("REFERRAL_CREATED" | "REFERRAL_ACTIVATED" | "REFERRAL_APPLICATION_STATUS_CHANGED" | "TRANSFER_PROCESSED" | "TRANSFER_FAILED" | "EXPENSE_PAYMENT_UPDATED" | "USER_UPDATED" | "EMBEDDED_CARD_TRANSACTION_UPDATED" | "EMBEDDED_CARD_UPDATED" | "EMBEDDED_ACCOUNT_UPDATED" | "EMBEDDED_CARD_SHIPPING_UPDATED" | "EMBEDDED_DISPUTE_UPDATED" | "PARTNERSHIP_INTEGRATION_CONNECTION_UPDATED" | "EMBEDDED_CARD_AUTHORIZATION" | "EMBEDDED_FRAUD_ALERT" | "EMBEDDED_BILLING_GROUP_UPDATED" | "EMBEDDED_LEGAL_ENTITY_UPDATED" | "EMBEDDED_BILLING_STATEMENT_UPDATED" | "EMBEDDED_USER_STATUS_UPDATED" | "ACCOUNTING_RECORD_READY_FOR_EXPORT")[]

List of event types that this webhook subscription listens to.

["EXPENSE_PAYMENT_UPDATED"]
put.responses.200.content.application/json.group_id?
Section titled “put.responses.200.content.application/json.group_id?”

optional group_id?: string | null

ID of the webhook group to which this subscription applies, if any.

wg_123
put.responses.200.content.application/json.id
Section titled “put.responses.200.content.application/json.id”

id: string

ID of the webhook subscription.

wsub_123
put.responses.200.content.application/json.status
Section titled “put.responses.200.content.application/json.status”

status: "ACTIVE" | "INACTIVE"

put.responses.200.content.application/json.url
Section titled “put.responses.200.content.application/json.url”

url: string

The URL to which webhook events will be sent. Must be a valid HTTPS URL.

https://example.com/webhook

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional trace?: undefined


/v1/webhooks/groups: object

Defined in: src/webhooks/types.gen.ts:56

optional delete?: undefined

get: object

List Webhook Groups

Lists webhook groups.

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: object

optional cursor?: string | null

Cursor for pagination.

optional limit?: number

Limit for pagination. If not provided, defaults to 100. Cannot be greater than 1000.

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.items
Section titled “get.responses.200.content.application/json.items”

items: object[]

get.responses.200.content.application/json.next_cursor?
Section titled “get.responses.200.content.application/json.next_cursor?”

optional next_cursor?: string | null

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

post: object

Create Webhook Group

Creates a webhook group.

parameters: object

optional cookie?: undefined

header: object

Idempotency-Key: string

optional path?: undefined

optional query?: undefined

requestBody: object

content: object

application/json: object

post.requestBody.content.application/json.name
Section titled “post.requestBody.content.application/json.name”

name: string

The name for the webhook group.

Some Webhook Group

responses: object

200: object

Success

content: object

post.responses.200.content.application/json
Section titled “post.responses.200.content.application/json”

application/json: object

post.responses.200.content.application/json.id
Section titled “post.responses.200.content.application/json.id”

id: string

The ID of the webhook group.

wg_123
post.responses.200.content.application/json.name
Section titled “post.responses.200.content.application/json.name”

name: string

The name for the webhook group.

Some Webhook Group

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional put?: undefined

optional trace?: undefined


/v1/webhooks/groups/{id}: object

Defined in: src/webhooks/types.gen.ts:80

delete: object

Delete Webhook Group

Deletes a webhook group and all its members.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

The ID of the webhook group to delete.

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

Success

optional content?: undefined

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

get: object

Get Webhook Group

Gets a webhook group.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

The ID of the webhook group to retrieve.

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.id
Section titled “get.responses.200.content.application/json.id”

id: string

The ID of the webhook group.

wg_123
get.responses.200.content.application/json.name
Section titled “get.responses.200.content.application/json.name”

name: string

The name for the webhook group.

Some Webhook Group

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined


/v1/webhooks/groups/{id}/add_members: object

Defined in: src/webhooks/types.gen.ts:104

optional delete?: undefined

optional get?: undefined

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

post: object

Add Webhook Group Members

Adds members to webhook groups.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

The ID of the webhook group to add members to.

optional query?: undefined

requestBody: object

content: object

application/json: object

post.requestBody.content.application/json.members
Section titled “post.requestBody.content.application/json.members”

members: object[]

The list of webhook group members to add to the group.

responses: object

200: object

Success

optional content?: undefined

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional put?: undefined

optional trace?: undefined


/v1/webhooks/groups/{id}/members: object

Defined in: src/webhooks/types.gen.ts:124

optional delete?: undefined

get: object

List Webhook Group Members

Lists the members currently in the specified webhook group.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

The ID of the webhook group to retrieve members for.

optional query?: object

optional cursor?: string | null

Cursor for pagination.

optional limit?: number

Limit for pagination. If not provided, defaults to 100. Cannot be greater than 1000.

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object

get.responses.200.content.application/json.items
Section titled “get.responses.200.content.application/json.items”

items: object[]

get.responses.200.content.application/json.next_cursor?
Section titled “get.responses.200.content.application/json.next_cursor?”

optional next_cursor?: string | null

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined


/v1/webhooks/groups/{id}/remove_members: object

Defined in: src/webhooks/types.gen.ts:144

optional delete?: undefined

optional get?: undefined

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

post: object

Remove Webhook Group Members

Removes members from webhook groups.

parameters: object

optional cookie?: undefined

optional header?: undefined

path: object

id: string

The ID of the webhook group to remove members from.

optional query?: undefined

requestBody: object

content: object

application/json: object

post.requestBody.content.application/json.members
Section titled “post.requestBody.content.application/json.members”

members: object[]

The list of webhook group members to remove from the group.

responses: object

200: object

Success

optional content?: undefined

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional put?: undefined

optional trace?: undefined


/v1/webhooks/secrets: object

Defined in: src/webhooks/types.gen.ts:164

optional delete?: undefined

get: object

List Webhook Secrets

This endpoint returns a set of webhook signing secrets used to validate the webhook. Usually only one key will be returned in the response. After key rotation, this endpoint will return two keys: the new key, and the key that will be revoked soon. There will also be two signatures in the ‘Webhook-Signature’ request header. Your application should use all keys available to validate the webhook request. If validation passes for any of the keys returned, the webhook payload is valid.

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional requestBody?: undefined

responses: object

200: object

Success

content: object

get.responses.200.content.application/json
Section titled “get.responses.200.content.application/json”

application/json: object[]

headers: object

[name: string]: unknown

400: object

Bad request

optional content?: undefined

headers: object

[name: string]: unknown

401: object

Unauthorized

optional content?: undefined

headers: object

[name: string]: unknown

403: object

Forbidden

optional content?: undefined

headers: object

[name: string]: unknown

500: object

Internal server error

optional content?: undefined

headers: object

[name: string]: unknown

optional head?: undefined

optional options?: undefined

parameters: object

optional cookie?: undefined

optional header?: undefined

optional path?: undefined

optional query?: undefined

optional patch?: undefined

optional post?: undefined

optional put?: undefined

optional trace?: undefined