Create a new customer

Creates a new customer in the system with their personal and contact information.

This endpoint allows you to register new customers and store their details for future transactions.

Use Cases

• Register new customers for payment processing
• Store customer information for recurring payments
• Maintain customer profiles for transaction history

Example: Create New Customer

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[e-mail]",
  "phone_number": "[phone]",
  "customer_type": "Startup",
  "status": "ACTIVE"
}

Required Fields

• first_name: Customer’s first name (1-100 characters)
• last_name: Customer’s last name (1-100 characters)
• phone_number: Customer’s phone number (max 20 characters)

Optional Fields

• email: Valid email address (max 255 characters)
• customer_type: Type of customer account (Individual, Startup, Small Business, Medium Business, Enterprise, Non-Profit, Government)
• status: Customer status (ACTIVE, BLACKLISTED, DEACTIVATED)

POST /api/v0/customers

Create a new customer

cURL

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",
  "phone_number": "[phone]",
  "email": "[e-mail]",
  "customer_type": "Individual",
  "status": "ACTIVE"
}
'

Authorizations

x-client-secretx-client-key

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.

Pattern: ^[+]?[1-9]\d{1,14}$

Example:

"[phone]"

email · string<email>

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

Example:

"[e-mail]"

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

201

Customer created successfully