Create Customer

Testing

Testing Env

https://api.staging.mintedconnect.com

POST

/partner/customer

Last modified:2025-07-17 14:48:47

Maintainer:Not configured

Method will be create a customer

Request

Authorization

Provide your encrypted digest scheme data in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Digest username=guest, realm="test", nonce="2", uri="/uri", response="***"

Header Params

api-version

string

optional

Example:

x-client-id

string

required

Default value: web

Default:

web

Accept-Language

string

optional

Default:

Body Params application/json

external_id

string

required

Your unique id for customer.

>= 3 characters<= 40 characters

Match pattern:

^[A-Za-z0-9-_]$

firstname

string

optional

>= 3 characters<= 40 characters

middlename

string

optional

>= 3 characters<= 40 characters

lastname

string

optional

>= 3 characters<= 40 characters

string <email>

optional

phone

string

optional

gender

enum<string>

optional

Allowed values:

identity_number

string

optional

birthdate

string

optional

Match pattern:

^[9999-99-99]$

Example

{
    "external_id": "{% faker datatype.uuid %}",
    "firstname": "{% faker name.firstName %}",
    "middlename": "",
    "lastname": "{% faker name.lastName %}",
    "email": "{% faker internet.email %}",
    "phone": "+90 532 280 80 35",
    "gender": "M",
    "identity_number": "12345677938",
    "birthdate": "1970-01-31"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.staging.mintedconnect.com/partner/customer' \
--header 'api-version: 2' \
--header 'api-version;' \
--header 'x-client-id;' \
--header 'Accept-Language: tr' \
--header 'Content-Type: application/json' \
--data-raw '{
    "external_id": "{% faker datatype.uuid %}",
    "firstname": "{% faker name.firstName %}",
    "middlename": "",
    "lastname": "{% faker name.lastName %}",
    "email": "{% faker internet.email %}",
    "phone": "+90 532 280 80 35",
    "gender": "M",
    "identity_number": "12345677938",
    "birthdate": "1970-01-31"
}'

Responses

🟢200OK

application/json

Body

data

object

required

integer

optional

external_id

string

required

company_id

integer

optional

user_id

integer | null

optional

firstname

string

required

middlename

string

optional

lastname

string

required

fullname

string

optional

string

required

phone

string

optional

gender

enum<string>

required

Allowed values:

identity_number

string

optional

birthdate

string

year-month-day

optional

Example:

1970-01-01

created_at

string

optional

updated_at

string

optional

success

boolean

required

code

integer

required

message

string

required

Example

{
    "data": {
        "id": 2,
        "external_id": "MTD0018232",
        "company_id": 2000000,
        "user_id": null,
        "firstname": "Mehmet",
        "middlename": null,
        "lastname": "Gülbilge",
        "fullname": "Mehmet Gülbilge",
        "email": "[email protected]",
        "phone": null,
        "gender": null,
        "identity_number": null,
        "birthdate": null,
        "created_at": "2023-03-05 04:51:18",
        "updated_at": "2023-03-05 04:51:18"
    },
    "success": true,
    "code": 0,
    "message": ""
}

🟠422Parameter Error

Modified at 2025-07-17 14:48:47

Sell (Silver)

Create Business Customer