curl -X POST https://api.notvis.com/v1/push/identify \
-H "Content-Type: application/json" \
-d '{
"account_id": "your-account-id",
"device_id": "device-uuid-123",
"external_id": "user-12345"
}'
await fetch('https://api.notvis.com/v1/push/identify', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
account_id: 'your-account-id',
device_id: deviceId,
external_id: currentUserId,
}),
});
{
"contact_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"identified": true
}
{
"code": 404,
"message": "contact not found"
}
Push Notifications
Identify User
Link an anonymous device to an identified user. No API key required.
POST
/
v1
/
push
/
identify
curl -X POST https://api.notvis.com/v1/push/identify \
-H "Content-Type: application/json" \
-d '{
"account_id": "your-account-id",
"device_id": "device-uuid-123",
"external_id": "user-12345"
}'
await fetch('https://api.notvis.com/v1/push/identify', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
account_id: 'your-account-id',
device_id: deviceId,
external_id: currentUserId,
}),
});
{
"contact_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"identified": true
}
{
"code": 404,
"message": "contact not found"
}
This endpoint is designed for client-side SDKs and does not require an API key. Call this after a user logs in to associate their push-enabled device with their user profile.
Request Body
string
required
Your Notvis account ID.
string
required
The device ID used during registration. Used to look up and transfer push tokens from the anonymous device contact to the identified user.
string
The Notvis contact ID of the identified user. Either
contact_id or external_id is required.string
Your application’s user ID. Used to look up the Notvis contact. Either
contact_id or external_id is required.Response
string
The resolved contact ID of the identified user.
boolean
Always
true on success.curl -X POST https://api.notvis.com/v1/push/identify \
-H "Content-Type: application/json" \
-d '{
"account_id": "your-account-id",
"device_id": "device-uuid-123",
"external_id": "user-12345"
}'
await fetch('https://api.notvis.com/v1/push/identify', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
account_id: 'your-account-id',
device_id: deviceId,
external_id: currentUserId,
}),
});
{
"contact_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"identified": true
}
{
"code": 404,
"message": "contact not found"
}