POST
/
recipients
cURL
curl -X POST https://api.bodhveda.com/recipients \
  -H "Authorization: Bearer bv_xxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "recipient_123",
    "name": "Alice Johnson"
  }'
{
  "message": "Recipient created",
  "data": {
    "id": "recipient_123",
    "name": "John Doe",
    "created_at": "2025-11-07T05:31:56Z",
    "updated_at": "2025-11-07T05:31:56Z"
  }
}
If a recipient with the given id already exists, this will return a conflict error. 💡 You should use this API during your user sign up flow.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer bv_xxxxxxxxx, where bv_xxxxxxxxx is your API Key with Full access scope.

Body

application/json

Response

201
application/json

Recipient created successfully

The response is of type any.