Webhook Registration

Requirements

You need to register and verify the endpoint you'd like to receive webhooks. The Order Submit API will POST to this endpoint as events occur, retrying if needed if your endpoint does not return a valid response.

POST /api/callback/create

Content-type: application/json

Example Request

1
2
3
4
curl https://apps.whcc.com/api/callback/create  \
	-H "Authorization: Bearer 726670514499" \
	-F callbackUri=https://path.to.your/webhook/endpoint \
	-X POST

We will immediately POST to callbackUri with a parameter verifier with a unique verification code. Use the endpoint below to submit this verification code to prove you control the endpoint and enable webhooks to be sent to that address.

POST /api/callback/verify

Content-type: application/json

Example Request

1
2
3
4
curl https://apps.whcc.com/api/callback/verify  \
	-H "Authorization: Bearer 726670514499" \
	-F verifier=a53ae191-00f3-44f4-810c-19d88a5b4c16 \
	-X POST

Your webhook endpoint is now setup and ready to go.