Create a hosted Saperly phone connection.

POST JSON body. Protected by x402 exact payment. Returns the Saperly connection id.

{
  "body": {
    "agentName": "string (optional, default 'Saperly x402 agent')"
  }
}

Provision a Saperly phone number.

POST JSON body. Protected by x402 exact payment. Number rent and upstream usage are handled by Sherwood's Saperly integration.

{
  "body": {
    "country": "string (optional, e.g. 'US')",
    "numberType": "local | mobile | tollFree (optional)",
    "areaCode": "string (optional)"
  }
}

Attach a phone number to a hosted Saperly connection.

Replace {numberId}. POST JSON body. Protected by x402 exact payment.

{
  "path": {
    "numberId": "string"
  },
  "body": {
    "connectionId": "string (required)"
  }
}

Release a Saperly phone number.

Replace {numberId}. Protected by x402 exact payment.

{
  "path": {
    "numberId": "string"
  }
}

List SMS messages for a Saperly number.

GET with numberId query parameter. Protected by x402 exact payment.

{
  "query": {
    "numberId": "string (required)"
  }
}

Send an SMS from a Saperly number.

POST JSON body. Protected by x402 exact payment. Saperly compliance and consent checks still apply upstream.

{
  "body": {
    "fromNumberId": "string (required)",
    "to": "string (required, E.164)",
    "body": "string (required)"
  }
}

List calls for a Saperly number.

GET with numberId query parameter. Protected by x402 exact payment.

{
  "query": {
    "numberId": "string (required)"
  }
}

Place an outbound call from a Saperly number.

POST JSON body. Protected by x402 exact payment. Use a number provisioned through this service as fromNumberId.

{
  "body": {
    "fromNumberId": "string (required)",
    "to": "string (required, E.164)",
    "instructions": "string (optional)"
  }
}