Create a custom namespace in the Identity Service API

Using the Identity Namespace API, you can create a custom identity namespace that will be available only to your organization.

For recommendations around creating custom namespaces, see the Identity Service FAQ documentation.


Namespaces are a qualifier for identities. As such, once a namespace has been created, it cannot be deleted.

API format

POST /idnamespace/identities


curl -X POST \ \
  -H 'Accept-Encoding: gzip, deflate' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
        "name": "Loyalty Member",
        "code": "Loyalty",
        "description": "Loyalty Program Member ID",
        "idType": "Cross_device"


    "updateTime": 1576286879075,
    "code": "Loyalty",
    "status": "ACTIVE",
    "description": "Loyalty Program Member ID",
    "id": 10093197,
    "createTime": 1576286879075,
    "idType": "Cross_device",
    "name": "Loyalty Member",
    "custom": true

Next steps

Proceed to the next tutorial to list the native ID of an identity

On this page