> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.agentphone.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.agentphone.ai/_mcp/server.

# Troubleshooting

> Diagnose setup, delivery, voice, billing, and account-scope problems.

Start with the exact account, resource ID, and error response. The API’s request ID helps support trace a failed action; do not repeatedly resend a message or call while its outcome is unknown.

| Symptom                                            | Check first                                                              | Next step                                                                                                                                                           |
| -------------------------------------------------- | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| iMessage option does not work on a standard number | Number type and subscription                                             | [Buy and activate an iMessage line](/imessage). Buying a standard SMS number does not enable iMessage.                                                              |
| Registration says approved but SMS is blocked      | Exact number’s `outboundSms`, registration scope, and `X-Sub-Account-Id` | Follow [approved-registration troubleshooting](/sms-registration#approved-registration-but-sending-is-blocked).                                                     |
| iMessage returns `429`                             | `error.code`, not just the HTTP status                                   | Separate the [daily quota, reply-required limit, and inactivity restriction](/documentation/reference/messaging-rate-limits#imessage).                              |
| New conversations are paused                       | Safety code and recent engagement                                        | Stop new outreach. Existing replies may continue. Contact support if review is needed.                                                                              |
| API accepts a text but it never arrives            | Original message in number/conversation history                          | Inspect `status` and `failureReason`. Acceptance is not delivery; see [delivery failures](/documentation/reference/error-handling#delivery-failures-failurereason). |
| Incoming text produces no response                 | Number attachment, selected webhook, and delivery log                    | Hosted voice prompts do not reply to texts. Your app must call the messaging API.                                                                                   |
| Webhook returns `401`                              | Saved signing secret and raw body                                        | Use the [signature verifier](/documentation/guides/webhooks#security); do not re-serialize JSON before verification.                                                |
| Voice caller hears silence                         | Voice mode, current transcript, and HTTP response                        | Return speech for a voice turn and inspect [voice troubleshooting](/documentation/guides/calls#troubleshooting-voice-calls).                                        |
| Calls fail with `402`, `409`, or `429`             | Funding, number readiness, and active calls                              | Follow [outbound calling requirements](/documentation/guides/calls#create-outbound-call).                                                                           |
| Balance is low despite auto-recharge being on      | Paused recharge and failed payment attempts                              | [Update the payment method and resume funding](/usage#auto-recharge-is-enabled-but-not-topping-up).                                                                 |
| SIP creation returns `403`                         | SIP access in the selected account                                       | Request access from the SIP trunking tab; see [SIP trunking](/sip-trunking).                                                                                        |
| Resources appear missing                           | Parent versus sub-account selection                                      | Use the same [account scope](/sub-accounts) for creation, lookup, registration, and sending.                                                                        |

## What to send support

Email [founders@agentphone.to](mailto:founders@agentphone.to) with:

* What you expected and what happened, with the time and timezone.
* The endpoint, HTTP status, `error.code` or `detail`, and `X-Request-Id`/`request_id`.
* The relevant agent, number, conversation, message, call, or delivery ID.
* Whether you are using a sub-account, and a minimal request with credentials and personal message content removed.

For API feedback you can also [submit feedback](/feedback). Do not include API keys, signing secrets, payment card information, or recording/media bearer URLs in public issues.