POST
/
customers
curl --request POST \
  --url https://api.sandbox.sudo.cards/customers \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "individual",
  "name": "<string>",
  "phoneNumber": "<string>",
  "emailAddress": "<string>",
  "individual": {
    "firstName": "<string>",
    "lastName": "<string>",
    "otherNames": "<string>",
    "dob": "<string>",
    "identity": {
      "type": "BVN",
      "number": "<string>"
    },
    "documents": {
      "idFrontUrl": "<string>",
      "idBackUrl": "<string>",
      "incorporationCertificateUrl": "<string>",
      "addressVerificationUrl": "<string>"
    }
  },
  "company": {
    "name": "<string>",
    "identity": {
      "type": "BVN",
      "number": "<string>"
    },
    "officer": {
      "firstName": "<string>",
      "lastName": "<string>",
      "otherNames": "<string>",
      "dob": "<string>",
      "identity": {
        "type": "BVN",
        "number": "<string>"
      },
      "documents": {
        "idFrontUrl": "<string>",
        "idBackUrl": "<string>",
        "incorporationCertificateUrl": "<string>",
        "addressVerificationUrl": "<string>"
      }
    },
    "documents": {
      "idFrontUrl": "<string>",
      "idBackUrl": "<string>",
      "incorporationCertificateUrl": "<string>",
      "addressVerificationUrl": "<string>"
    }
  },
  "status": "active",
  "billingAddress": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>"
  }
}'
"{}"

Authorizations

​
Authorization
string
header
default:{{APIKey}}
required

Body

application/json
​
type
enum<string>
default:individual
required

This is the customer type.

Available options:
individual,
company
​
name
string
required

The customer's full name.

​
phoneNumber
string
required

Customer's mobile phone number in international format.

​
status
enum<string>
default:active
required

This is the initial status of the customer.

Available options:
active,
inactive
​
billingAddress
object
required

This is the billing address

​
emailAddress
string

Customer's email address.

​
individual
object

Individual details. Required if customer type is individual.

​
company
object

Company details. Required if customer type is company.

Response

200
application/json
200

The response is of type object.