Add leads
Add leads to a campaign by platform IDs, usernames, external IDs, or a mixed leads array. Profiles not yet in the system will be fetched automatically.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The ID of the campaign.
^[0-9a-z]+$Body
Platform for platformIds / usernames. Currently optional and defaults to twitter, the only supported platform. It will become required for platformIds / usernames once additional platforms are supported — set it explicitly now to avoid future breakage. Ignored for externalIds, which are platform-agnostic.
twitter Platform user IDs. Maximum 2000 per request.
1 - 2000 elements1["44196397", "50393960"]Usernames (handles). Profiles not yet in the system will be fetched automatically. Maximum 2000 per request.
1 - 2000 elements1["elonmusk", "jack"]Inbox external IDs (platform-agnostic). Maximum 2000 per request.
1 - 2000 elements1["hy4k7m2x9p1n6v3w8j5q0r"]Mixed leads, each identified by platformId, username, or externalId, with optional per-lead column data.
1 - 2000 elementsResponse
OK
Number of leads successfully added to the campaign.
0 <= x <= 9007199254740991Number of leads that were already in the campaign.
0 <= x <= 9007199254740991Number of identifiers that could not be resolved (invalid, suspended, or deleted accounts).
0 <= x <= 9007199254740991