Skip to main content
POST
/
ppi
/
user
Create PPI User
curl --request POST \
  --url https://api.cashfree.com/ppi/user \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '{
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+919876543210",
  "email": "john.doe@example.com",
  "address": {
    "address": "123 Main St",
    "city": "Bangalore",
    "state": "Karnataka",
    "country": "India",
    "pincode": "560001"
  },
  "status": "ACTIVE"
}'
{
  "user_id": "7234567890123456789",
  "first_name": "John",
  "last_name": "Doe",
  "phone": "+919876543210",
  "email": "john.doe@example.com",
  "address": {
    "address": "123 Main St",
    "city": "Bangalore",
    "state": "Karnataka",
    "country": "India",
    "pincode": "560001"
  },
  "status": "ACTIVE"
}

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree.

​
x-client-secret
string
header
required

The secret key associated with your client ID.

Body

application/json
​
first_name
string
required

First name of the user.

Example:

"John"

​
last_name
string
required

Last name of the user.

Example:

"Doe"

​
phone
string
required

Phone number of the user with country code.

Example:

"+919876543210"

​
email
string
required

Email address of the user.

Example:

"john.doe@example.com"

​
address
object
​
status
enum<string>

Current status of the user account.

Available options:
ACTIVE,
INACTIVE,
SUSPENDED,
BLOCKED

Response

User created successfully.

​
user_id
string

Unique identifier for the user.

Example:

"1234567890123456789"

​
first_name
string

First name of the user.

Example:

"John"

​
last_name
string

Last name of the user.

Example:

"Doe"

​
phone
string

Phone number of the user with country code.

Example:

"+919876543210"

​
email
string

Email address of the user.

Example:

"john.doe@example.com"

​
address
object
​
status
enum<string>

Current status of the user account.

Available options:
ACTIVE,
INACTIVE,
SUSPENDED,
BLOCKED
⌘I