Create a webhook endpoint

POST 
/webhook_endpoints

Registers an endpoint for your application. The response is the only time the signing secret is returned; store it to verify signatures. Requires an owner, admin, or developer role in the application's organization.

On the sandbox API this returns 403 manage_endpoints_on_live_api: create test endpoints through the live API with mode: "test", and they are mirrored into sandbox.

Request

Responses

201

Endpoint created (includes the one-time secret)

401

Authentication required or token is invalid/expired. This error occurs when:

• No Authorization header is provided
• The access token is invalid or malformed
• The access token has expired
• The access token has been revoked

To resolve: Obtain a new access token using the OAuth 2.0 flow.

403

The authenticated user does not have permission to access this resource. This typically means:

• The user is authenticated but lacks the required OAuth scope
• The resource belongs to a different user
• The user's role doesn't allow this operation

Check that your OAuth token includes the necessary scopes for this endpoint.

422

Validation error (bad URL, unknown or missing events, invalid mode, or quota reached)