Skip to main content
POST
/
api
/
v1
/
dev
/
teams
/
{teamId}
/
customers
Create Customer
curl --request POST \
  --url https://app.lukittu.com/api/v1/dev/teams/{teamId}/customers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "email": "jsmith@example.com",
  "fullName": "<string>",
  "username": "<string>",
  "discordId": "<string>",
  "metadata": [
    {
      "key": "<string>",
      "value": "<string>",
      "locked": true
    }
  ],
  "address": {
    "street": "<string>",
    "city": "<string>",
    "state": "<string>",
    "country": "<string>",
    "postalCode": "<string>"
  }
}'
{
  "data": {
    "id": "789e0123-e89b-12d3-a456-426614174222",
    "email": "customer@example.com",
    "fullName": "John Doe",
    "username": "johndoe",
    "metadata": [
      {
        "key": "tier",
        "value": "standard",
        "locked": false
      }
    ],
    "address": {
      "street": "123 Main St",
      "city": "Anytown",
      "state": "CA",
      "country": "US",
      "postalCode": "12345"
    },
    "discordAccount": null,
    "teamId": "123e4567-e89b-12d3-a456-426614174000",
    "createdByUserId": "456e7890-e89b-12d3-a456-426614174111",
    "createdAt": "2023-09-15T14:30:00Z",
    "updatedAt": "2023-09-15T14:30:00Z"
  },
  "result": {
    "timestamp": "2023-09-15T14:30:00Z",
    "valid": true,
    "details": "Customer created"
  }
}

Authorizations

Authorization
string
header
required

API key authentication for development endpoints.

You can create API keys in your team's settings on the Lukittu dashboard. Include the API key in the Authorization header as: Bearer YOUR_API_KEY

Example:

Authorization: Bearer lukittu_api_key_abc123def456...

Path Parameters

teamId
string<uuid>
required

Your team's UUID. You can find this value in your team's settings on the Lukittu dashboard.

Body

application/json
email
string<email> | null
fullName
string | null
username
string | null
discordId
string | null

Discord user ID (snowflake). When provided, Discord user will be validated and associated with this customer.

metadata
object[]

Key-value metadata pairs

address
object

Response

Customer created successfully

data
object
required

Response data

result
object
required
I