---
updatedAt: 2026-09-11T11:40:44.000Z
agentTools:
  projectIndex: https://coinify.readme.io/llms.txt
---

# Create Customer

<Callout icon="👍" theme="okay">
  # Please contact `support@coinify.com` 

  so that we can start the process of enabling this endpoint for you.

  It is not possible to use Customer endpoints without the prior approval.
</Callout>

> 🚧 Make sure to get customer's consent to share the required data with Coinify before doing so.

<Callout icon="❗️" theme="error">
  ## Make sure to store the `id` returned by the endpoint

  This is the customer ID as stored in the Coinify's system. You will need it to e.g. pass the `coinifyCustomerId` when creating the [Payment Intent](https://coinify.readme.io/reference/create-payment-intent), [Read Customer's wallets info,](https://coinify.readme.io/reference/read-customer) [Create Customer Wallet ](https://coinify.readme.io/reference/create-customer-wallet)etc.
</Callout>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "payment-intent",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.payment.sandbox.coinify.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY",
        "x-default": ""
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/customers": {
      "post": {
        "description": "",
        "operationId": "post_new-endpoint",
        "responses": {
          "200": {
            "description": "",
            "content": {}
          },
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": {
                      "id": "2a2c8407-f7d2-49e6-9c8f-39f69a6e5644",
                      "wallets": []
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "examples": {
                  "Validation Error": {
                    "value": {
                      "errorCode": "restricted_country_error",
                      "errorMessage": "Customer cannot be created in the provided country"
                    },
                    "summary": "Validation Error"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "examples": {
                  "Authentication Error": {
                    "value": "",
                    "summary": "Authentication Error"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "examples": {
                  "Forbidden": {
                    "value": {
                      "errorCode": "forbidden",
                      "errorMessage": "Creating customers is not allowed for this merchant"
                    },
                    "summary": "Forbidden"
                  }
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/json": {
                "examples": {
                  "Payload Error": {
                    "value": "{\n  \"errorCode\": \"invalid_payload\",\n  \"errorMessage\": '\"country\" is required'\n}",
                    "summary": "Payload Error"
                  }
                }
              }
            }
          }
        },
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Full name of the customer. ",
                    "default": "Customer name"
                  },
                  "email": {
                    "type": "string",
                    "description": "Email of the customer.",
                    "default": "customer@merchant.com"
                  },
                  "country": {
                    "type": "string",
                    "description": "The residence country of the customer. <a href=\"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2\">ISO 3166-1 alpha-2</a>",
                    "default": "DK"
                  },
                  "subdivision": {
                    "type": "string",
                    "description": "Country subdivision. <b>Required if there's subdivisions within a country.</b> E.g. if country is US then this field is required to provide the exact residence state of the customer."
                  },
                  "address": {
                    "type": "string",
                    "description": "Address of the customer.",
                    "default": "Residence address"
                  },
                  "type": {
                    "type": "string",
                    "description": "Type of the customer. Available values: \"individual\" or \"business\"",
                    "default": "individual"
                  },
                  "dateOfBirth": {
                    "type": "string",
                    "format": "date",
                    "description": "Required if \"type\" = \"individual\". Format \"YYYY-MM-DD\". ",
                    "default": ""
                  },
                  "legalEntityIdentifier": {
                    "type": "string",
                    "description": "Required if \"type\" = \"business\". The legal identifier of the business. E.g. VAT number in EU."
                  },
                  "privacyConsent": {
                    "type": "boolean",
                    "description": "Can be \"true\" or \"false\". Specifies if the customer agreed with your Privacy Terms where you specify that you can share their data with Coinify for Travel Rule purposes. Or if you have received direct consent from the customer to share their data with Coinify. "
                  }
                },
                "type": "object",
                "required": [
                  "name",
                  "email",
                  "country",
                  "address",
                  "type",
                  "dateOfBirth",
                  "legalEntityIdentifier",
                  "privacyConsent"
                ]
              }
            }
          }
        },
        "summary": "Create Customer"
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```