Skip to main content
POST
/
identities
Create identity
curl --request POST \
  --url http://localhost:5001/identities \
  --header 'X-blnk-key: <api-key>'
Use client.Identity.Create to create an identity for an individual or organization.
1

Call the method

client.Identity.Create
dob, _ := time.Parse(time.RFC3339, "1990-01-15T00:00:00Z")

identity, resp, err := client.Identity.Create(blnkgo.Identity{
	IdentityType: blnkgo.Individual,
	FirstName: "Alice",
	LastName: "Smith",
	EmailAddress: "alice.smith@example.com",
	DOB: &dob,
})
FieldTypeDescription
IdentityTypeblnkgo.IdentityTypeIndividual or Organization.
2

Save the identity ID

Use identity.IdentityId to link balances or update profile details later.
3

Response

201 Created
{
  "identity_id": "idt_a8f2c91d-4b3c-4ef4-9ab1-a0decf3d0aa3",
  "identity_type": "individual",
  "first_name": "Alice",
  "last_name": "Smith",
  "email_address": "alice.smith@example.com",
  "phone_number": "+1234567890",
  "nationality": "Canadian",
  "category": "customer",
  "created_at": "2024-11-26T08:36:36.238244338Z",
  "meta_data": {
    "customer_id": "CUST123456"
  }
}
FieldTypeDescription
identity_idstringUnique ID for the identity. Use it to link balances.
identity_typestringType you passed in the request.
created_atstringDate and time the identity was created.
meta_dataobjectMetadata stored with the identity.
The response echoes every field you sent.

How identities work

Linking balances and handling profile data.

Create new identity

HTTP request and response schema.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.