Provision a phone number the agent can use — for receiving SMS (e.g. 2FA), sending SMS, or placing/receiving voice calls.

Use this BEFORE signing up for a service that asks for a phone number, or before making outbound calls. If phone_number is given, provisions that specific number; otherwise auto-searches by area_code.

Returns a dict with id, phone_number (E.164 format — pass this to forms), provider, and status. Save the returned phone_number — you need it to later release_number or wait_for_sms.

Release a previously provisioned phone number. Call this when done to avoid ongoing Telnyx monthly charges. Pass the E.164 phone_number returned by provision_number.

List all phone numbers currently provisioned on this account. Useful when the agent needs to find a number it forgot about, or audit what's active.

Send an outbound SMS from a provisioned number. from_number must be a number you already provisioned; to_number is the recipient in E.164 format (e.g. "+15551234567"). Outbound US SMS, international SMS, and inbound SMS all work — Agentline's 10DLC campaign is approved across all major US carriers.

Long-poll (blocking up to timeout seconds, max 180) for the next inbound SMS on a provisioned number. Use this right AFTER submitting a form that triggers an SMS — call this to catch the reply.

match is an optional regex (e.g. \d{6} for a 6-digit code) — only messages matching the pattern satisfy the wait. Any inbound message satisfies it when match is None.

Returns the message dict (with body and auto-extracted extracted_code when present), or {"message": null, "status": "timeout"} if no message arrived in time.

All-in-one 2FA capture: provision a fresh phone number, wait for an incoming SMS verification code (4-8 digits by default), then release the number. THE killer flow for signups.

Typical use: call this, take phone_number from the result and paste into the signup form, then code will be the extracted 2FA code once it arrives. If no code arrives in timeout seconds, code is null.

Set release_after=False if you plan to keep using the number.

Place an outbound AI voice call. An AI agent answers when the recipient picks up and follows prompt as its system instructions; first_message is what it says on connect.

Returns immediately with the id (call_id) — the call runs in the background. Poll get_call(call_id) to see status, transcript, and summary once it completes.

voice is a Deepgram TTS voice (aura-asteria-en, aura-orion-en, …).

Get status, transcript, and summary for a call. Call this after make_call to check whether the call has completed. Terminal statuses are completed, failed, no_answer, busy — anything else means the call is still in progress and you should poll again.

End an in-progress call immediately. No-op / error if the call already terminated.

Provision a new email address for sending and receiving mail. Use this when signing up for services that require email verification — the agent gets a real inbox.

local_part is the part before the @ (e.g. "my-agent"); leave null to auto-generate. Returns id, email_address (full address to paste into forms), provider, status.

List all email addresses currently provisioned on this account.

Release a provisioned email address. Pass the id returned from create_email_address (NOT the full email string).

Send an outbound email from a provisioned address. from_email must be one of your provisioned addresses.

Long-poll (blocking up to timeout seconds, max 180) for the next inbound email on a provisioned address. Use right after triggering an email (e.g. a 'check your email' signup step).

match is an optional regex run against the message body. Returns the message dict on match (includes subject, body_text, extracted_code), or {"message": null, "status": "timeout"} on timeout.

All-in-one email verification capture: provision an email address, wait for an incoming verification code (4-8 digits by default), release the address. Use for services that email verification codes instead of SMS.

Returns email_address (paste into the signup form) and code (the captured verification code). code is null on timeout.