Bulk import identities

UserVoice Admin API now provides a way to import many user identities at once. This is useful if you already have sizeable information about your users, but want to import that information to UserVoice platform. With it, you will be able to analyze user satisfaction, feedback and support requests by account, plan, lifetime value, and other traits.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
POST /api/v2/admin/bulk_identify

{
  "identities": [
    {
      email:      'john.doe@example.com', // User’s email address
      name:       'John Doe', // User’s real name
      created_at: 1364406966, // Unix timestamp for the date the user signed up
      id:         123, // Optional: Unique id of the user (if set, this should not change)
      type:       'Owner', // Optional: segment your users by type
      account: {
        id:           123, // Optional: associate multiple users with a single account
        name:         'Acme, Co.', // Account name
        created_at:   1364406966, // Unix timestamp for the date the account was created
        monthly_rate: 9.99, // Decimal; monthly rate of the account
        ltv:          1495.00, // Decimal; lifetime value of the account
        plan:         'Enhanced' // Plan name for the account
      }
    },
    // ... up to 1000 identities at once
  ]
}

In the identities array, each object is the same as the identity object specified in Identifying users and passing traits document. The length of this array should be at least 1 and at most 1000.

A successful API call yields:

1
2
3
4
5
HTTP/1.1 202 StatusAccepted

{
  "status": "queued"
}

These imported identities are queued and will be available later.

That’s all!

Didn’t find what you’re looking for?

Check out the UserVoice Help Center for more documentation.

Explore the Help Center