> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Post Call Webhook

> Create and send post call webhooks for specified calls.

## Overview

Create and send post call webhooks for one or more call IDs. This endpoint allows you to create webhooks for calls that don't already have webhooks configured. The webhooks will be sent immediately after creation to the specified webhook URL. If the call has already sent a post call webhook, this endpoint will return an error.

***

## Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

***

## Body Parameters

<ParamField body="call_ids" type="string[]" required>
  Array of call IDs to create and send webhooks for. Each call ID must be unique within the array.

  <Expandable title="Array Item Properties">
    <ResponseField name="call_id" type="string">
      The unique identifier of a call to create a webhook for.
    </ResponseField>
  </Expandable>
</ParamField>

<ParamField body="webhook_url" type="string" required>
  The URL where the webhook payloads should be sent.
</ParamField>

***

## Response

<ResponseField name="data" type="array">
  Array of webhook objects for each created webhook.

  <Expandable title="Array Item Properties">
    <ResponseField name="call_id" type="string">
      The unique identifier of the call this webhook is for.
    </ResponseField>

    <ResponseField name="payload" type="object">
      The webhook payload data that was sent.
    </ResponseField>

    <ResponseField name="url" type="string">
      The URL the webhook was sent to.
    </ResponseField>

    <ResponseField name="user_id" type="string">
      The ID of the user/org that owns this webhook.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp of when the webhook was created.
    </ResponseField>

    <ResponseField name="metadata" type="array">
      Array of metadata objects about webhook send attempts.

      <Expandable title="Array Item Properties">
        <ResponseField name="sent_at" type="string">
          Timestamp of when this webhook attempt was sent.
        </ResponseField>

        <ResponseField name="response_code" type="integer">
          HTTP response code received from the webhook endpoint.
        </ResponseField>

        <ResponseField name="response_time" type="string">
          Time taken to receive a response from the webhook endpoint.
        </ResponseField>

        <ResponseField name="send_type" type="string">
          How this webhook was triggered (will be "create" in this case).
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="errors" type="array">
  Array of error objects if any errors occurred.

  <Expandable title="Array Item Properties">
    <ResponseField name="error" type="string">
      The error code. Possible values:

      * "invalid\_parameter": Invalid request parameters
      * "INTERNAL\_SERVER\_ERROR": Server error occurred
    </ResponseField>

    <ResponseField name="message" type="string">
      Detailed error message.
    </ResponseField>
  </Expandable>
</ResponseField>

***

Docs for agents: [llms.txt](/llms.txt)