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

# Enable assistant inbound webhook

> Activate inbound webhook notifications for an assistant

Enable real-time webhook notifications for inbound calls. You'll receive notifications when inbound calls complete with all call data.

### Request Body

<ParamField body="assistant_id" type="integer" required>
  The identifier of the assistant to enable webhooks for
</ParamField>

<ParamField body="webhook_url" type="string" required>
  The endpoint URL where notifications will be sent
</ParamField>

### Response

<ResponseField name="message" type="string">
  Success confirmation message
</ResponseField>

<ResponseField name="data" type="array">
  Empty array (reserved for future functionality)
</ResponseField>

### Error Responses

<ResponseField name="404 Not Found">
  <Expandable title="Error Response">
    <ResponseField name="message" type="string">
      Error when the assistant doesn't exist or belongs to another account
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="422 Validation Error">
  <Expandable title="Error Response">
    <ResponseField name="message" type="string">
      Validation error message
    </ResponseField>

    <ResponseField name="errors" type="object">
      Detailed field-level validation errors
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 200 Success Response theme={null}
  {
    "message": "Webhook enabled successfully",
    "data": []
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "message": "Assistant not found"
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The given data was invalid.",
    "errors": {
      "assistant_id": [
        "The assistant id field is required."
      ],
      "webhook_url": [
        "The webhook url field is required."
      ]
    }
  }
  ```
</ResponseExample>

<Tip>
  Related pages: [Introduction](/en/api-reference/introduction) and [Authentication Guide](/en/developers/authentication-guide), and [API Integration Examples](/en/developers/api-integration-examples).
</Tip>