Issuers

Create an issuer

POST/v1/issuers

Creates an issuer identity. Unverified until the contact mailbox is confirmed.

API key · or dashboard session.

Request

Shell
curl -fsS "$API/v1/issuers" \
  -H "Authorization: Bearer $PAYDAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Acme LLC", "contact_email": "billing@acme.example" }'

Response

201 Created
{
  "id": "iss_0198f80c-2222-7dc1-a369-90556a64f700",
  "name": "Acme LLC",
  "contact_email": "billing@acme.example",
  "details": null,
  "email_verified": false,
  "email_verified_at": null,
  "payout_addresses": [],
  "created_at": "2026-09-06T12:00:00Z",
  "updated_at": "2026-09-06T12:00:00Z"
}

Body

namestringrequired
1–255 bytes. Unique per account, case- and whitespace-insensitive.
contact_emailstringrequired
3–254 bytes. Lowercased. Not unique.
detailsstring
≤4,000 bytes.

Response

Issuer.

Status codes

  • 409issuer_name_taken