POST/v1/smm/orders

Create an order

Places an SMM order against a service from the catalog.

Required scope: smm.orderRate limit: 10 rps

Parameters

service_slugstringrequired

The SMM service's slug (from GET /smm/services).

linkstringrequired

The target profile/post URL.

quantityintegerrequired

How many units to order, within the service's min/max.

Code samples

curl -X POST "https://samaprime.com/api/v1/smm/orders" \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"service_slug":"example","link":"example","quantity":1000}'

Response

→ 201
{
  "data": {
    "id": "cm_smmord_01J8Y2A3BBCCDD",
    "status": "placed",
    "quantity": 1000,
    "sell_usd": "3.5000",
    "provider_order_id": "panel_ord_998877"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-08-06T12:00:00Z"
  }
}

Errors

Status	Code
404	`service_unavailable` No active service matches this slug.
400	`quantity_out_of_range` Quantity is outside the service's min/max range.
400	`invalid_link` The link doesn't match the service's expected platform.
422	`insufficient_balance` Wallet balance is lower than the order's cost.
500	`provider_error` The upstream SMM panel declined or failed the order — the charge was refunded.