Skip to Content

Connect Saperly to Your AI Agent

Configure numbers and handlers, then use voice and SMS with your workspace permissions.

48 toolsAPI key

20,000 free app calls every month(paid services billed separately)

Try a Saperly Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillSaperly

Check usage and number costs

Review balance and quote a number before provisioning.

/oo Saperly: Use Saperly to show my balance and usage, then quote a [number type] number in [country].

Start Working with Saperly

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Saperly

    Create a key in Settings → Keys after signing in at https://saperly.com/sign-in.

    Connect Saperly→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • A Saperly API key with read access for connection validation.
  • Write permission and sufficient prepaid balance for paid operations; admin permission for key management.
  • Number allow-lists, spending caps and consent checks are enforced by Saperly.
  • Custom voice uploads use public audio URLs up to 20 MiB. Manual-mode connections require your own external handler.
  • Call and voice processing status can be polled. Recording links are temporary.

Saperly Tools

Provision numbers, configure hosted or manual connections, discover or upload voices, manage consent, send messages and retrieve call records. Workspace tools cover usage, scoped API keys, webhooks and audit events.

Phone numbers

Quote, provision, configure and release numbers.

Connections and voices

Configure hosted or manual handlers, discover voices and upload custom voice samples.

Calls, SMS and consent

Manage consent, send SMS, place calls and retrieve call artifacts.

Workspace and key management

Read usage, manage scoped keys and webhooks, inspect audit events and ask the workspace assistant.

48 tools

Health

Liveness probe

saperly.health

List Workspace Members

List the workspace members

saperly.list_workspace_members

List Workspace Keys

List the workspace API tokens

saperly.list_workspace_keys

Create Workspace Key

Create a scoped API token

saperly.create_workspace_key

List Workspace Webhooks

List the workspace webhook endpoints

saperly.list_workspace_webhooks

Create Workspace Webhook

Create a webhook endpoint

saperly.create_workspace_webhook

List Webhook Deliveries

List a webhook endpoint's recent delivery attempts

saperly.list_webhook_deliveries

List Workspace Audit Events

List the workspace audit-log events

saperly.list_workspace_audit_events

Revoke Workspace Key

Revoke an API token

saperly.revoke_workspace_key

Send Workspace Invitation

Invite a member by email

saperly.send_workspace_invitation

Ask Assistant

Ask the workspace assistant a question; the assistant may use workspace tools.

saperly.ask_assistant

List Numbers

List all phone numbers in the workspace

saperly.list_numbers

Provision Number

Provision a phone number

saperly.provision_number

Get Number

Get a phone number by id

saperly.get_number

Release Number

Release a phone number

saperly.release_number

Assign Connection

Bind a connection to a number

saperly.assign_connection

Set Number Webhook

Set a number's manual-mode brain URL

saperly.set_number_webhook

Set Sms Sender

Set the alphanumeric SMS sender id

saperly.set_sms_sender

Set Caller Id

Set the outbound caller ID name (CNAM)

saperly.set_caller_id

List Connections

List all connections in the workspace

saperly.list_connections

Create Connection

Create a connection (provisions inline)

saperly.create_connection

Get Connection

Get a connection by id

saperly.get_connection

Update Connection

Update a connection (re-syncs the carrier)

saperly.update_connection

Delete Connection

Delete a connection

saperly.delete_connection

Send Message

Send an SMS message

saperly.send_message

List Messages

List messages (optionally filtered by number)

saperly.list_messages

Place Call

Place an outbound call

saperly.place_call

List Calls

List calls

saperly.list_calls

End Call

End a live call

saperly.end_call

Transfer Call

Blind-transfer a live call

saperly.transfer_call

Get Call

Get a call by id

saperly.get_call

Get Recording

Get a temporary download URL for a completed call recording.

saperly.get_recording

Get Transcript

Get a call transcript

saperly.get_transcript

List Voices

List available voices (optionally filtered by language)

saperly.list_voices

List Custom Voices

List custom voices

saperly.list_custom_voices

Create Custom Voice

Upload a voice sample from a public URL; poll get_custom_voice until the voice is active or failed.

saperly.create_custom_voice

Get Custom Voice

Get custom voice

saperly.get_custom_voice

Delete Custom Voice

Delete custom voice

saperly.delete_custom_voice

List Languages

List the supported spoken languages

saperly.list_languages

Get Usage

Get a usage summary (optionally since a timestamp)

saperly.get_usage

List Consent

List all consent records in the workspace

saperly.list_consent

Record Consent

Record consent for a contact

saperly.record_consent

Revoke Consent

Revoke consent for a contact

saperly.revoke_consent

Check Consent

Check whether a contact has active consent

saperly.check_consent

Get Price Quote

Quote the price of a phone number

saperly.get_price_quote

List Keys

List the workspace's API keys

saperly.list_keys

Mint Key

Mint a scoped API key

saperly.mint_key

Revoke Key

Revoke an API key

saperly.revoke_key

Frequently Asked Questions

Why can a request be denied with a valid key?

Scopes, number allow-lists, spending caps and consent can restrict an operation. Check the returned Saperly error before replacing the key.