Create a webhook endpoint

POST /api/v1/webhook_endpoints

Creates a new webhook endpoint object.

application/json

Body

  • description string

    A human-readable description of the webhook endpoint.

  • url string Required

    The URL of the webhook endpoint.

Responses

  • 201 application/json

    Returns the webhook endpoint object if the post succeeded.

    Hide response attributes Show response attributes object
    • created string
    • description string

      Optional human-readable description of the endpoint.

    • id string
    • secret string

      Webhook secret which you can use to verify that the webhook is from 1099Policy. Read more about how to use the webhook secret to verify the webhook signature in our documentation here.

    • url string

      The URL of the webhook endpoint.
POST /api/v1/webhook_endpoints 
curl \
 -X POST https://api.1099policy.com/api/v1/webhook_endpoints \
 -H "Content-Type: application/json" \
 -d '{"url":"https://example.com/my/webhook/endpoint","description":"Webhook for contractor insurance application events."}'
Request example 
{
  "url": "https://example.com/my/webhook/endpoint",
  "description": "Webhook for contractor insurance application events."
}
Response examples (201) 
{
  "created": "2024-01-06T05:30:39.373Z",
  "description": "string",
  "id": "whe_KPGc5vEZdvoETu39BNwu2Z",
  "secret": false,
  "url": "https://example.com/my/webhook/endpoint"
}