Documentation | Users › Identify User

Users

users

Methods

Delete User -> string

delete/v1/users/{user_id}

Delete user

Get User ->

User

get/v1/users/{user_id}

Get user

Get Channel Data ->

ChannelData

get/v1/users/{user_id}/channel_data/{channel_id}

Get channel data

Get Preference Set ->

PreferenceSet

get/v1/users/{user_id}/preferences/{preference_set_id}

Get preference set

List Users -> EntriesCursor<

User

get/v1/users

List users

List Messages -> EntriesCursor<

Message

get/v1/users/{user_id}/messages

List messages

List Preference Sets -> Array<

PreferenceSet

get/v1/users/{user_id}/preferences

List preference sets

List Schedules -> EntriesCursor<

Schedule

get/v1/users/{user_id}/schedules

List schedules

List Subscriptions -> EntriesCursor<

Subscription

get/v1/users/{user_id}/subscriptions

List subscriptions

Merge Users ->

User

post/v1/users/{user_id}/merge

Merge two users together, where the user specified with the from_user_id param will be merged into the user specified by user_id.

Set Channel Data ->

ChannelData

put/v1/users/{user_id}/channel_data/{channel_id}

Set channel data

Update Preference Set ->

PreferenceSet

put/v1/users/{user_id}/preferences/{preference_set_id}

Updates a complete preference set for a user. This is a destructive operation that will replace the existing preference set for the user.

Unset Channel Data -> string

delete/v1/users/{user_id}/channel_data/{channel_id}

Unset channel data

Identify User ->

User

put/v1/users/{user_id}

Identify user

Parameters

user_id: string

Response fields

User

Request example

curl https://api.knock.app/v1/users/$USER_ID \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $KNOCK_API_KEY" \
    -d '{
      "channel_data": {
        "97c5837d-c65c-4d54-aa39-080eeb81c69d": {
          "data": {
            "tokens": [
              "push_token_xxx"
            ]
          }
        }
      },
      "preferences": {
        "default": {}
      }
    }'

200Example

{
  "id": "jane",
  "__typename": "User",
  "updated_at": "2024-05-22T12:00:00Z",
  "avatar": "avatar",
  "created_at": null,
  "email": "[email protected]",
  "name": "Jane Doe",
  "phone_number": "phone_number",
  "timezone": "timezone"
}

Domain types

IdentifyUserRequest = { channel_data, created_at, preferences }

A set of parameters to identify a user with. Does not include the user ID, as that's specified elsewhere in the request. You can supply any additional properties you'd like to upsert against the user.

InlineIdentifyUserRequest = { id, channel_data, created_at, 1 more... }

A set of parameters to inline-identify a user with. Inline identifying the user will ensure that the user is available before the request is executed in Knock. It will perform an upsert against the user you're supplying, replacing any properties specified.

User = { id, __typename, updated_at, 6 more... }

A user object

Users