> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.truvo.com/llms.txt.

# request_callback

* **Callers:** partner key
* **Label:** Write
* **Side effects:** Queues a callback for a licensed advisor to place. A repeat ask for the same number folds into the open callback.
* **Limits:** Partner or platform key, sandbox: 100 quote requests a minute per key, 300 a minute per organization, and 5,000 a UTC day per organization. Live: 60 quote requests a minute per organization by default, and the key's own bound when it has one.
* **Hints:** `readOnlyHint: false`, `destructiveHint: false`
* **Result:** `id` of the callback request and its `status`: `queued`, or `already_queued` when the number already had an open callback.
* **HTTP:** [`POST /v1/callback_requests`](/api-reference/request-callback)

## Input

| Field              | Type                         | Description                                                                                            |
| ------------------ | ---------------------------- | ------------------------------------------------------------------------------------------------------ |
| `phone` Required   | string, up to 32 characters  | The number Truvo should call, a US number a person can answer.                                         |
| `name`             | string, up to 200 characters | The person's name, when they gave one.                                                                 |
| `reason`           | string, up to 500 characters | Why the person wants a call, in their words.                                                           |
| `quote_request_id` | string                       | The quote request the person wants help with, when they have one.                                      |
| `line`             | string                       | The line the person is asking about, when they named one. One of `personal_auto`, `renters`, or `pet`. |
| `state`            | string                       | The US state the person is asking about, when they named one.                                          |

## Description

`tools/list` returns this description to a partner key:

> Queues a call back to the person on Truvo's staffed advisor line, which is available 24/7. Ask the person for the number Truvo should call, and send it only after they ask for a callback. Give them advisor_line.phone from get_capabilities if they want to call now. A repeat ask for the same number folds into the open callback.