Skip to main content
POST
/
webhooks
cURL
curl \
  -X POST 'MEILISEARCH_URL/webhooks' \
  -H 'Content-Type: application/json' \
  --data-binary '{
    "url": "WEBHOOK_TARGET_URL",
    "headers": {
      "authorization": "SECURITY_KEY",
      "referer": "https://example.com"
    }
  }'
{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "url": "https://your.site/on-tasks-completed",
  "headers": {
    "Authorization": "Bearer a-secret-token"
  },
  "isEditable": true
}

Authorizations

​
Authorization
string
header
required

An API key is a token that you provide when making API calls. Read more about how to secure your project.

Include the API key to the Authorization header, for instance:

-H 'Authorization: Bearer 6436fc5237b0d6e0d64253fbaac21d135012ecf1'

If you use a SDK, ensure you instantiate the client with the API key, for instance with JS SDK:

const client = new Meilisearch({
  host: 'MEILISEARCH_URL',
  apiKey: '6436fc5237b0d6e0d64253fbaac21d135012ecf1'
});

Body

application/json

Configuration for a webhook endpoint

​
url
string | null

URL endpoint to call when tasks complete.

Example:

"https://your.site/on-tasks-completed"

​
headers
object

HTTP headers to include in webhook requests.

Example:
{ "Authorization": "Bearer a-secret-token" }

Response

Webhook created successfully.

Webhook object with metadata and redacted authorization headers.

​
uuid
string<uuid>
required

Unique identifier of the webhook.

​
isEditable
boolean
required

Whether the webhook can be edited.

​
url
string | null

URL endpoint to call when tasks complete.

Example:

"https://your.site/on-tasks-completed"

​
headers
object

HTTP headers to include in webhook requests.

Example:
{ "Authorization": "Bearer a-secret-token" }