Working with Identities

​

Adding an identity to a profile

curl -X POST https://api.[tenant].getomneo.com/api/v3/profiles/{profileId}/identities \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "handle": "shopify",
    "identifier": "6432187489345"
  }'

​

Common identity handles

​

Looking up a profile by identity

GET /api/v3/identities/search?handle=shopify&identifier=6432187489345

​

Browsing identities for a profile

GET /api/v3/profiles/{profileId}/identities

​

Updating an identity

PUT /api/v3/profiles/{profileId}/identities/{identityId}

​

Deleting an identity

DELETE /api/v3/profiles/{profileId}/identities/{identityId}

​

Best practices

• Always check if an identity exists before adding it: duplicate identities will return an error
• Use the identity search endpoint at the start of each integration request to resolve the Omneo profile ID
• Store the Omneo profile ID alongside the external identity in your system for faster lookup
• Use identity search for real-time POS lookup flows where speed matters