Skip to main content
POST
/
client
Create a new client
curl --request POST \
  --url https://api.rivoopay.com/client \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "name": "Cliente Bola",
  "status": "ACTIVE",
  "taxId": "05305405364",
  "email": "bola@email.com",
  "phone": "41999999999",
  "address": "Rua Engenheiros Rebouças",
  "district": "Rebouças",
  "number": "2000",
  "postalCode": "80215100",
  "line1": "Green apartment"
}
'
{
  "id": "clnt_clx1234567890abcdef",
  "taxId": "053.054.053-64",
  "name": "Cliente Bola",
  "email": "bola@email.com",
  "phone": "41999999999",
  "status": "ACTIVE",
  "companyId": "comp_clx9876543210fedcba",
  "createdAt": "2025-02-03T10:00:00Z",
  "updatedAt": "2025-02-03T10:00:00Z",
  "postalCode": "80215100",
  "address": "Rua Engenheiros Rebouças",
  "district": "Rebouças",
  "number": "2000",
  "line1": "Green apartment"
}

Authorizations

​
X-API-KEY
string
header
required

Body

application/json

Client data to create

​
name
string
required

Client full name

Maximum string length: 255
Example:

"Cliente Bola"

​
status
enum<string>
default:ACTIVE
required

Client status

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
taxId
string
required

Client tax ID (CPF/CNPJ). Will be automatically formatted to remove non-numeric characters

Pattern: ^[0-9]{11,14}$
Example:

"05305405364"

​
email
string<email>
required

Client email address

Example:

"bola@email.com"

​
phone
string
required

Client phone number (Brazilian format)

Pattern: ^[0-9]{10,11}$
Example:

"41999999999"

​
address
string | null

Client street address

Example:

"Rua Engenheiros Rebouças"

​
district
string | null

District/neighborhood

Example:

"Rebouças"

​
number
string | null

Street number

Example:

"2000"

​
postalCode
string | null

Client postal code (CEP)

Pattern: ^[0-9]{8}$
Example:

"80215100"

​
line1
string | null

Address complement (line 1)

Example:

"Green apartment"

Response

Client created successfully

​
id
string
required

Client unique identifier (format: clnt_{cuid2})

Example:

"clnt_clx1234567890abcdef"

​
taxId
string
required

Client tax ID (CPF/CNPJ) - formatted

Pattern: ^[0-9]{11,14}$
Example:

"053.054.053-64"

​
name
string
required

Client full name

Maximum string length: 255
Example:

"Cliente Bola"

​
email
string<email>
required

Client email address

Example:

"bola@email.com"

​
phone
string
required

Client phone number (Brazilian format)

Pattern: ^[0-9]{10,11}$
Example:

"41999999999"

​
status
enum<string>
default:ACTIVE
required

Client status

Available options:
ACTIVE,
INACTIVE
Example:

"ACTIVE"

​
companyId
string
required

Company ID that owns this client (format: comp_{cuid2})

Example:

"comp_clx9876543210fedcba"

​
createdAt
string<date-time>
required

Client creation timestamp

Example:

"2025-02-03T10:00:00Z"

​
updatedAt
string<date-time>
required

Client last update timestamp

Example:

"2025-02-03T10:00:00Z"

​
postalCode
object

Client postal code (CEP)

Example:

"80215100"

​
address
object

Client street address

Example:

"Rua Engenheiros Rebouças"

​
district
object

District/neighborhood

Example:

"Rebouças"

​
number
object

Street number

Example:

"2000"

​
line1
object

Address complement (line 1)

Example:

"Green apartment"