Search the Omeda Knowledge Base
-
-
-
-
- Behavior Lookup By Customer Id
- Customer Change Lookup
- Customer Comprehensive Lookup By Customer Id
- Customer Lookup By Customer Id
- Customer Lookup By Email Address
- Customer Lookup By EncryptedCustomerId
- Customer Lookup By External ID
- Customer Lookup By Name and Country
- Customer Lookup By PostalAddressId
- Customer Merge History Lookup
- Demographic Lookup By Customer Id
- Email Address Lookup By Customer Id
- External ID Lookup By Customer Id
- Phone Lookup By Customer Id
- Postal Address Lookup By Customer Id
- Subscription Lookup By Customer Id
- Subscription Lookup By Email
- Customer Lookup by Hashed Email Address
- Order History Lookup by Customer Id
- Show all articles ( 4 ) Collapse Articles
-
- Email Deployment
- Email Audience Assignment Status
- Email Clicks
- Email Deployment Add Audience
- Email Deployment Approval Lookup
- Email Deployment Audience List FTP
- Email Deployment Cancel
- Email Deployment Clone
- Email Deployment Content
- Email Deployment Content Lookup
- Email Deployment Lookup
- Email Deployment Remove Audience
- Email Deployment Schedule
- Email Deployment Search
- Email Deployment Test
- Email Deployment Unschedule
- Email On Demand Send
- Email Opt In/Out Lookup
- Email Optin Queue
- Email Optout Queue
- Email Flag Email As Invalid
- Show all articles ( 6 ) Collapse Articles
-
-
-
- Release Notes for V20.17
- Release Notes for V20.16
- Release Notes for V20.15
- Release Notes for V20.14
- Release Notes for V20.13
- Release Notes for V20.12
- Release Notes for V20.11
- Release Notes for V20.10
- Release Notes for V20.9
- Release Notes for V20.8
- Release Notes for V20.7
- Release Notes for V20.6
- Release Notes for V20.5
- Release Notes for V20.4
- Release Notes for V20.3
- Release Notes for V20.2
- Release Notes for V20.1
- Show all articles ( 2 ) Collapse Articles
-
- Release Notes for V19.17
- Release Notes for V19.16
- Release Notes for V19.15
- Release Notes for V19.14
- Release Notes for V19.13
- Release Notes for V19.12
- Release Notes for V19.11
- Release Notes for V19.10
- Release Notes for V19.9
- Release Notes for V19.8
- Release Notes for V19.7
- Release Notes for V19.6
- Release Notes for V19.5
- Release Notes for V19.4
- Release Notes for V19.3
- Release Notes for V19.2
- Release Notes for V19.1
- Show all articles ( 2 ) Collapse Articles
-
-
-
-
- Customer Olytics Data
- Form Listener
- Olytics - Integration Description
- Olytics - Product Outline
- Olytics Comprehensive Lookup
- Olytics Customer Search
- Olytics Customer Top Values
- Reports - Web Behavior Reporting
- Web Behavioral Tracking (Olytics) - Overview & Capabilities
- Audience Builder (OnQ) - Querying Olytics Fields
-
-
-
-
-
- Email - Clickbot Reporting
- Reports - Audience Builder (OnQ) Reporting
- Reports - Audience Overlap Report
- Reports - Audience Report
- Reports - Data Tracker Reporting
- Reports - Email Reporting
- Reports - Issue Activity Reporting
- Reports - Web Behavior Reporting
- Reports - Overview
- Reports- FAQs
- Reports - Email Device and Client Type Reporting
-
-
-
- Email Deployment
- Email Audience Assignment Status
- Email Clicks
- Email Deployment Add Audience
- Email Deployment Approval Lookup
- Email Deployment Audience List FTP
- Email Deployment Cancel
- Email Deployment Clone
- Email Deployment Content
- Email Deployment Lookup
- Email Deployment Remove Audience
- Email Deployment Schedule
- Email Deployment Search
- Email Deployment Test
- Email Deployment Unschedule
- Email On Demand Send
- Email Opt In/Out Lookup
- Email Optin Queue
- Email Optout Queue
- Email Flag Email As Invalid
- Email - Checklist for Sends Created via API Calls
- Show all articles ( 6 ) Collapse Articles
- Email Services - Overview & Capabilities
- Email Builder - User Guide
- Email - Deployment Checklist & Best Practices
- Omeda - Getting Support
- Email - Advanced Features
- Email - A/B Testing
- Email - Appending Lists On Triggered Deployments
- Email - Assigning Link Tracking Categories
- Email - Automated ACS Notifications
- Email - Deliverability
- Email - Dynamic Content
- Email - FAQs
- Email - Glossary
- Email - Link Tracking Errors
- Email - Merge Variables
- Email - Preference Page
- Email - Recurring Deployments
- Email - Triggered Deployments
- Email - User Set-up
- Email - Web Tracking
- Email - Web Tracking String Parameter Definitions
- Email Builder - Getting Started
- Email - Stealth Link
- Email - Clickbot Reporting
- Email - Validation Services
- Email - Opt-Out Footer Merge Variable
- Reports - Email Reporting
- Email - Whitelisting Email Newsletters
- Email - Request a New Deployment Type
- Email - Behavioral Data
- Email - Deployment Defaults
- Email - Deployment Type Creation
- Email - Automation for Email Sending
- Show all articles ( 18 ) Collapse Articles
-
-
-
- Odyssey - Audience Element
- Odyssey - Timing Elements
- Odyssey - Email Element
- Odyssey - Filter Element
- Odyssey - Form Submit Element
- Odyssey - Export Element
- Odyssey - Split Element
- Odyssey - Personalization Element
- Odyssey - Metering Element
- Odyssey - Pathfinder Element
- Odyssey - Google Ad Manager Element
- Odyssey - Adroll Elements
- Odyssey - Facebook Elements
- Odyssey - Goal Element
- Odyssey Overview
- Odyssey - FAQs
- Odyssey - Reporting
- Odyssey - Querying Element Visitors in Audience Builder
- Odyssey - Using Profiles
- Odyssey - Email Merge Variables
- Odyssey - Omeda's Email Designer
- Odyssey - Email Designer Templates
- Odyssey - Merging Paths
- Odyssey - Creating Custom Templates
- Odyssey - Voyage Templates
- Odyssey - Editing an In Progress Voyage
- Odyssey - Error Troubleshooting
- Odyssey - Dynamic Content
-
-
-
-
- Audience Builder (OnQ) - Admin User Guide
- Audience Builder (OnQ) - How To Query Customers
- Audience Builder (OnQ) - Match Evaluation
- Audience Builder (OnQ) - Overview
- Audience Builder (OnQ) - Query Result Outputs
- Reports - Audience Builder (OnQ) Reporting
- Email - Behavioral Data
- Audience Builder (OnQ) - Advanced Features
- Audience Builder (OnQ) - Querying Olytics Fields
-
-
-
-
-
- How to conditionally display a question on your form (video)
- How to create and add an email confirmation to your form (video)
- How to update a demographic (video)
- How To Use A/B Testing on your Dragon Webform (video)
- How To Use Progressive Profiling
- How to send a user back to your website after form submission (redirect to a return URL)
- Form Builder - Export URL
- Best practices for testing forms
- Dragon Forms URL Structure and Appending Parameters
- Form Builder (Dragon) - Overview
- Form Builder (Dragon) Themes
- Form Builder ADA Compliance
- Styling Your Dragon Webforms
- Test links v. live links
- Using a Custom Domain for your Dragon Webform
- Using Dragon Form Builder to capture a Behavior Subscription Attribute
- 2020 Form Builder Updates
- Form Builder - Using Campaign Promo Codes
-
-
-
- Knowledge Base Home
- Documentation
- API & Webservices
- Email Builder APIs
- Email Audience Assignment Status
Email Audience Assignment Status
Summary
The List Assignment Status API provides the ability to get the status of a customer list that is currently being assigned from the Omail FTP Site to a deployment. For more information on triggering the assignment process, please see Deployment Audience Service.
Base Resource URI
For Production, use: https://ows.omeda.com/webservices/rest/brand/{brandAbbreviation}/omail/deployment/audience/status/{listId}/* For Testing, use: https://ows.omedastaging.com/webservices/rest/brand/{brandAbbreviation}/omail/deployment/audience/status/{listId}/*
- brandAbbreviation
- is the abbreviation for the brand to which the data is being posted.
- listId
- is the numeric list id returned from Deployment Add Audience.
Technical Requirements
The HTTP header must contain the following elements:
- x-omeda-appid
- a unique id provided to you by Omeda to access your data. The request will fail without a valid id.
- content-type
- a content type supported by this resource. See Supported Content Types for more details. If omitted, the default content type is application/json.
Supported Content Types
If omitted, the default content type is application/json.
- JSON
- application/json
JSON is the preferred data exchange format, because it is lightweight and, in most cases, faster to process and utilizes less bandwidth. There are many available open-source JSON libraries available. See json.org for details.
Supported HTTP Methods
There is one HTTP method supported:
- GET
- See W3C’s GET specs for details.
Field Definition
The following tables describe the hierarchical data elements.
List Assignment Response Elements
Attribute Name | Required? | Data Type | Description |
---|---|---|---|
ListId | required | integer | Numeric identifier for the list. |
AssignmentStatusCode | required | string | The current status of the list as it is being assigned. Valid values are:”LIST_REMOVED”, “QUEUED”, “IN_PROCESS”, “DONE”, “WARNING”, and “ERROR”. |
TrackId | required | string | The unique identifier for the deployment that the list belongs to. |
SplitNumber | required | integer | The deployment split that the list belongs to. |
RecipientList | conditional | string | The name of the list for the list id being queried. |
RecipientCount | conditional | integer | If the AssignmentStatus object returns DONE, this will return the number of Recipient records that were attached to the Deployment. |
QueryName | conditional | string | The name of the Query that is being assigned. |
Message | conditional | string | Optional message. Example: ‘There were 4 invalid recipient records; 4 of which contain invalid email addresses.’ |
Response Examples
Two responses are possible: a successful POST (200 OK Status) or a failed POST (400 Bad Request/403 Forbidden/404 Not Found/405 Method Not Allowed Statuses). See W3C’s Status Codes.
Successful Submission
{ "SubmissionId" : "C95AE90C-BEC6-41F2-91E2-2BA9168D1D1F", "ListId":100345, "TrackId":"FOO020030012", "AssignmentStatus":"IN_PROCESS", "SplitNumber": 1, "RecipientList": "subscribers.csv" }
Failed Submission
Potential errors:
File not found for audience list id '{listId}' No deployment found for '{listId}' Deployment '{trackId}' associated with this file was created within the Omail portal and is not eligible for API access. Deployment '{trackId}' assocated with this file has been edited from the Omail portal and is not eligible for API access. Last edited by {userName} on {changedDate}. List removed: Audience list '{fileName}' was removed by {userId} on {removalDate}.
A failed POST submission may be due to several factors:
Status | Description |
---|---|
400 Bad Request | Typically, this error occurs when the request does not follow the specifications. |
403 Forbidden | Typically, this error occurs when the credentials are erroneous. Potentially, an incorrect x-omeda-appid. |
404 Not Found | Typically, this error occurs with a malformed URL or the resource that is searched for is not found. This can occur if the ListId submitted in the url is not found in Omail. |
405 Method Not Allowed | Typically, this error occurs when the resource accessed is not allowed by the HTTP Method utilized. Make sure you employ the correct HTTP Method (GET) for this request. |
409 Conflict | Typically, this error occurs when their was a problem during the list assignment process associated with the content of the list. Example: File contained no valid recipient records. |
This is not an exhaustive list of errors, but common ones. If an error occurs repeatedly, please contact your Omeda representative.
JSON Example
{ "SubmissionId" : "C95AE90C-BEC6-41F2-91E2-2BA9168D1D1F", "Errors" : [ { Error": "'ListId' is a required field." }, { "Error": "ListId 10043 was not found." }, { "Error": "File contained no valid recipient records." } ] }