Execute a test event

Before deploying your webhook endpoint function into a live environment, we recommend you to conduct thorough testing of your application integration. POST is the http method used to send data to the server to create or update a resource. Replace {URI} with the actual base URI and use /webhooks/{webhookId}/tests/{testName} as the specific path of the endpoint targeting the webhook you want to test.

The following endpoint can be used to test your webhook subscription. Replace {webhookId} with the unique identifier of the webhook and {testName} with the name of the test you want to run:

EndpointPurpose
POST {URI}/webhooks/{webhookId}/tests/{testName}To test webhook subscription

The following parameters are available for POST {URI}/webhooks/{webhookId}/tests/{testName}:

ParameterData typeRequirementDescription
webhookIdstringrequiredThe unique identifier of the webhook you want to test.
testNamestringrequiredThe name of the test you want to run. Currently only the ConnectivityTest is available for testing. See Connectivity test.

The following example shows how to structure your request to test your webhook subscription:

-- Request
curl --request POST \
     --url https://integration-api.tangocard.com/raas/v2/webhooks/{webhookId}/tests/{testName} \
     --header 'accept: application/json' \
     --header 'authorization: Basic or OAuth...'

-- Response
200 OK

Connectivity test

The first release of this test endpoint tests the connectivity of the subscription where {testName} is set to ConnectivityTest. This will look like POST {URI}/webhooks/{webhookId}/tests/ConnectivityTest. This test initiates an event type of ConnectivityTest, using the standard envelope, with no meta payload. Such testing is a crucial step to guarantee the reliability and effectiveness of your webhook integration before it goes live.

EndpointPurpose
POST {URI}/webhooks/{webhookId}/tests/ConnectivityTestTo execute a connectivity test

The possible response codes for this endpoint are as follows. For details, see i18nkey codes and their error messages:

  • 200 OK
  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found

© 2025 Tango API are provided by Tango, a division of BHN, Inc.