Skip to main content
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
​
id
string
required

Unique identifier from your system.

This cannot be changed after creation. So use a stable identifier that will not change over time.

​
name
string

Name of the recipient.

Response

Recipient created successfully