Input object
CampaignCreatorsPatchInput
Changes to a campaign's roster. At most 200 entries per call, add, addCreatorIds and remove together. Entries are independent: an invalid one is reported at its own path (e.g. ["input","creators","add","3","handle"]) and the rest still apply. The same profile in add and remove is refused in both.
Fields
Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.
- add [CampaignCreatorInput!] default []
- Creators to add. Asynchronous: each is queued for import and joins the roster once resolved (for CREATOR_MONITORING, Archive then pulls their posts back to dateStart and tracks new ones until dateEnd; on BRAND_MONITORING, capture is replayed for an added creator, so their in-window posts from brand-listening sources can be captured, including ones taken out earlier with posts.remove). On VETTING_WORKFLOW, Archive pulls and reviews their posts in the window. One already on the roster is a no-op.
- handle String! required
- The profile's username. Whitespace and a leading '@' are stripped and case is ignored.
- provider Provider! required
- The profile's platform. Which platforms a roster takes is the campaign type's rule: INSTAGRAM and TIKTOK for CREATOR_MONITORING and VETTING_WORKFLOW; INSTAGRAM, TIKTOK and YOUTUBE for CONTENT_CAPTURE and BRAND_MONITORING. No campaign type takes INTERNAL. Any other platform is refused on this entry.
- Instagram platform integration, including posts, reels, stories, and profile data.
- INTERNAL
- Internal Archive-managed source used for synthetic or system-generated content.
- TIKTOK
- TikTok platform integration, including videos and creator profile data.
- YOUTUBE
- YouTube platform integration, including Shorts, videos, thumbnails, and profile data.
- addCreatorIds [ID!] default []
- Creators already in the workspace to add, by creator id (from creators or creator). Synchronous: each joins the roster during the call, after any removals. A refused id is reported at its own path, e.g. ["input","creators","addCreatorIds","2"]. Refused: an unknown id, an id from another workspace, a full roster, a creator the campaign type does not admit. One already on the roster is a no-op.
- remove [CampaignCreatorInput!] default []
- Creators to take off the roster, now. Their captured posts stay in the campaign; on a CONTENT_CAPTURE or BRAND_MONITORING campaign, take them out with posts.remove. A creator is on the roster once, so any one of their profiles removes them. Also cancels an add of the same profile still waiting to import. One not on the roster is a no-op.
- handle String! required
- The profile's username. Whitespace and a leading '@' are stripped and case is ignored.
- provider Provider! required
- The profile's platform. Which platforms a roster takes is the campaign type's rule: INSTAGRAM and TIKTOK for CREATOR_MONITORING and VETTING_WORKFLOW; INSTAGRAM, TIKTOK and YOUTUBE for CONTENT_CAPTURE and BRAND_MONITORING. No campaign type takes INTERNAL. Any other platform is refused on this entry.
- Instagram platform integration, including posts, reels, stories, and profile data.
- INTERNAL
- Internal Archive-managed source used for synthetic or system-generated content.
- TIKTOK
- TikTok platform integration, including videos and creator profile data.
- YOUTUBE
- YouTube platform integration, including Shorts, videos, thumbnails, and profile data.