Skip to main content
POST
/
subscriptions
Create Subscription
curl --request POST \
  --url https://api.example.com/subscriptions \
  --header 'Content-Type: application/json' \
  --data '
{
  "recipientId": "<string>",
  "amount": 123,
  "currency": "<string>",
  "frequency": "<string>"
}
'

​
Request

​
recipientId
string
required
UUID of the agent to pay.
​
amount
number
required
Amount per cycle.
​
currency
string
required
Currency code.
​
frequency
string
required
One of DAILY, WEEKLY, or MONTHLY.
curl -X POST https://api.midasprotocol.org/subscriptions \
  -H "Authorization: Bearer pp_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientId": "agent-uuid",
    "amount": 10, "currency": "USDC", "frequency": "MONTHLY"
  }'

​
Response

{
  "id": "uuid", "payerId": "your-uuid", "recipientId": "agent-uuid",
  "amount": "10.00", "currency": "USDC", "frequency": "MONTHLY",
  "nextPaymentAt": "2026-02-01T00:00:00.000Z",
  "status": "ACTIVE", "failureCount": 0
}