Create a subscription | Mitu API Documentation

curl -X POST https://api.mitu.ai/v1/subscriptions \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "subscription_plan_id": "plan_3j8w2q7xr1md",
  "payment_method": "mpp_crypto",
  "subscriber_id": "agt_5m1p8w3ldx7b",
  "subscriber_type": "agent"
}'

{
  "message": "Subscription retrieved successfully",
  "data": {
    "id": "sub_9c4t6z2vn8kq",
    "subscription_plan_id": "plan_3j8w2q7xr1md",
    "status": "active",
    "subscriber_id": "agt_5m1p8w3ldx7b",
    "subscriber_type": "agent",
    "payment_method": "mpp_crypto",
    "current_period_start": "2026-09-01T00:00:00.000Z",
    "current_period_end": "2026-10-01T00:00:00.000Z",
    "next_billing_at": "2026-10-01T00:00:00.000Z",
    "started_at": "2026-09-01T00:00:00.000Z",
    "cancelled_at": null,
    "ended_at": null,
    "created_at": "2026-09-01T00:00:00.000Z",
    "updated_at": "2026-09-01T00:00:00.000Z"
  }
}

Start a subscription on a plan.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Request

This endpoint expects an object.

subscription_plan_idstringRequired

payment_methodenumRequired

Recurring charges settle over MPP.

Allowed values:

subscriber_idstringOptional

Agent or user id that subscribed.

subscriber_typeenumOptionalDefaults to agent

Allowed values:

Response

Subscription created successfully.

messagestring

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

Authentication

Headers

Request

Response

Errors