Skip to main content

​
POST /contact-books

Create a new contact book to organize your contacts.

​
Authentication

JWT Bearer token (dashboard auth)

​
Request Body

FieldTypeRequiredDescription
namestringYesContact book name

​
Response

{
  "success": true,
  "data": {
    "contactBook": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": "user_uuid",
      "name": "Newsletter Subscribers",
      "created_at": "2026-03-07T12:00:00Z",
      "updated_at": "2026-03-07T12:00:00Z"
    }
  }
}

​
Example

curl -X POST https://app.usesendi.com/api/contact-books \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter Subscribers"
  }'

​
Errors

StatusErrorCause
400Invalid request dataMissing required fields
403Contact book limit reachedFree plan allows a maximum of 2 contact books