Skip to content

Get help fast

Most answers are already in a guide. If yours isn't, tell us which step failed and when, and we'll take it from there.

Start with the guide for your setup

  • Quickstart: from a new workspace to your first code.
  • CLI: connect from a terminal, mark a line and wait for a text.
  • API reference: endpoints, scopes and error codes.
  • Playwright: read a real code inside a test.
  • CI: a read-only key and one line per worker.
  • Integrations: set up Claude Code, Codex, Cursor or OpenCode.

Report a delivery problem stage by stage

A text can fail to leave, fail to arrive, or arrive and not get picked up. Walk through each stage so we can tell which one it was.

  1. Number. The line's label and whether it's Standard or Mobile.
  2. Mark. Whether you marked the line, or captured a cursor, before your app sent the text.
  3. Send. Whether your app or its SMS provider reported the text as sent, and when, with time zone.
  4. Receipt. Whether the text showed up in the Phonekit inbox, and how long you waited.
  5. Read. Your CLI or SDK version or the API endpoint, and the sanitized error or exit code.

If the number itself might be the problem, read VoIP vs. real SIM numbers to see which line type your flow needs.

What never to send

Leave API keys, cookies, passwords, recovery codes and the full text of any message out of your request. A line label, a timestamp and a sanitized error are enough to start. If a key ends up somewhere it shouldn't, revoke it and create a new one before you write to us.

Contact us

Email support@phonekit.io from a work email we can reply to. Say what you're building and where it stops. For an agent setup, name the agent and where it runs. A person reads every message.

New to Phonekit? Get a number instead.

Questions

What should I check after a wait times out?

Check that your app sent the text to the right Phonekit number, and that you marked the line before it sent. A text that arrived before the mark doesn't count. If both look right, report the stage that failed and the approximate time.

What does an unauthorized or unavailable number error mean?

The key or session you're using can't read that number. An API key only reads the numbers selected for it, even if you can see the number in the workspace. The API errors and CLI exit codes in the docs list each case.

Will a service accept my Phonekit number?

It depends on the service. Standard numbers are US local VoIP lines, and some services won't text VoIP numbers. Mobile numbers are real SIM lines on a mobile network, for services that only text mobiles. No number is accepted by every service, so test the flows your product depends on before you rely on them.

Still stuck?

Email support@phonekit.io with the step that failed. Keep keys and codes out of it.

Email support