Sandbox

sandboxItemFireWebhook

POST
/sandbox/item/fire_webhook

The /sandbox/item/fire_webhook endpoint is used to test that code correctly handles webhooks. Calling this endpoint triggers a Transactions DEFAULT_UPDATE webhook to be fired for a given Sandbox Item. If the Item does not support Transactions, a SANDBOX_PRODUCT_NOT_ENABLED error will result.

Authorization

PLAID-CLIENT-ID PLAID-SECRET Plaid-Version
PLAID-CLIENT-ID<token>

In: header

PLAID-SECRET<token>

In: header

Plaid-Version<token>

In: header

Request Body

application/json

SandboxItemFireWebhookRequest defines the request schema for /sandbox/item/fire_webhook

client_id?string

Your Plaid API client_id. The client_id is required and may be provided either in the PLAID-CLIENT-ID header or as part of a request body.

secret?string

Your Plaid API secret. The secret is required and may be provided either in the PLAID-SECRET header or as part of a request body.

access_token*string

The access token associated with the Item data is being requested for.

webhook_code*string

The following values for webhook_code are supported:

  • DEFAULT_UPDATE

Response Body

application/json

application/json

curl -X POST "https://example.com/sandbox/item/fire_webhook" \  -H "Content-Type: application/json" \  -d '{    "access_token": "string",    "webhook_code": "DEFAULT_UPDATE"  }'
{  "webhook_fired": true,  "request_id": "1vwmF5TBQwiqfwP"}