Skip to main content
GET
Calling Add-ons
The Try it panel runs against production with the key you paste. POST charges your card.
Every phone line includes calling: 500 outgoing minutes per line per month (pooled across your phone lines) with call recording, unlimited incoming calls forwarded to one number in the same country as the eSIM, and extra minutes at $3 per 100. Regular calls go out through Telnyx using your line’s number. The person you call may see “Potential spam” unless they saved your number or tapped “Mark as known” — text them first. Carriers grade each call with a STIR/SHAKEN attestation, and because Telnyx can’t own the number your line uses for iMessage, calls are attested B rather than A. This is industry-wide: every iMessage provider, Sendblue included, calls from an iMessage number with B — an A needs a carrier-owned number, and those can only do SMS, not iMessage. Two add-ons avoid that:

List — GET /api/lines/{id}/calling-addons

string
required
The line’s _id.
status is one of none, awaiting_payment (pay paymentUrl), pending_setup (paid — we’re setting it up), active, or canceled.

Buy — POST /api/lines/{id}/calling-addons

  • addon — facetime_audio or caller_id_registration.
  • acceptCharges — must be true: you agree to the setup fee plus today’s prorated share of the monthly, then monthly. Non-refundable. Without it: 422.
The card on file is charged immediately. Returns 201 with status: "pending_setup" once paid, or 202 with status: "awaiting_payment" and a paymentUrl only when the card is declined or the bank requires authentication (3-D Secure) — the customer confirms there, and the add-on starts once paid. An unpaid paymentUrl lapses after about 23 hours; the add-on then goes back to none and can be bought again. Buying an add-on the line already has returns 409, and so does buying one while another add-on payment on the workspace is still waiting ("code": "PAYMENT_IN_PROGRESS") — pay or let that one lapse first. Registered caller ID calls are billed at $0.075 each, added to your next invoice.

Removing an add-on

Add-ons can’t be removed after purchase. Contact support@tuco.ai to change them. DELETE /api/lines/{id}/calling-addons returns 403 with "code": "ADDON_REMOVAL_SUPPORT_ONLY".

Ordering add-ons with a new line

Send callingAddons and acceptCallingAddonCharges: true on Create Line Request. Add-ons bought with your plan at checkout attach to new lines automatically, with no second charge.