Skip to main content

Create User List Upload Job

Loading...
API endpoint path: /pss/v1/fis/{fiId}/audiences/userListJobs

Enqueues a job to upload a named user list to Promotions Suite. The request returns a jobId immediately. The user list becomes available as a campaign audience after the job reaches the Uploading or Completed state.

Use this endpoint to:

  • Upload a user list programmatically without using the Promotions Suite UI.
  • Create or update a campaign audience from member IDs generated by an external workflow.
  • Obtain a jobId to track user list upload progress.

Behavior and capabilities:

  • name is required, max 50 characters, and may contain only letters, numbers, spaces, underscores (_), and hyphens (-).
  • users is required and must contain at least one retail banking member ID.
  • description is optional, max 200 characters. If omitted, the default value is Originally uploaded on {timestamp}.

Next Steps​

After the job is accepted, use the Get User List Upload Job endpoint to monitor job status and upload progress.

Request​

Responses​

Accepted