POST
/
api
/
v0
/
customers
Create a new customer
curl --request POST \
  --url https://api.devdraft.ai/api/v0/customers \
  --header 'Content-Type: application/json' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "phone_number": "+1-555-123-4567",
  "customer_type": "Individual",
  "status": "ACTIVE"
}'

Authorizations

​
x-client-secret
string
header
required

Your secret API key. Keep this secure and never expose it in client-side code.

Body

application/json

Customer creation data

​
first_name
string
required

Customer's first name. Used for personalization and legal documentation.

Required string length: 1 - 100
Example:

"John"

​
last_name
string
required

Customer's last name. Used for personalization and legal documentation.

Required string length: 1 - 100
Example:

"Doe"

​
phone_number
string
required

Customer's phone number. Used for SMS notifications and verification. Include country code for international numbers.

Example:

"+1-555-123-4567"

​
email
string<email>

Customer's email address. Used for notifications, receipts, and account management. Must be a valid email format.

Example:

"john.doe@example.com"

​
customer_type
enum<string>
default:Individual

Type of customer account. Determines available features and compliance requirements.

Available options:
Individual,
Startup,
Small Business,
Medium Business,
Enterprise,
Non-Profit,
Government
Example:

"Individual"

​
status
enum<string>
default:ACTIVE

Current status of the customer account. Controls access to services and features.

Available options:
ACTIVE,
BLACKLISTED,
DEACTIVATED,
DELETED
Example:

"ACTIVE"

Response

Customer created successfully