Email Deployment Search

Knowledge Base Home

Search the Omeda Knowledge Base

Summary

This service retrieves a list of most recent deployments for a given brand based on search parameters.

Base Resource URI

Production: https://ows.omeda.com/webservices/rest/brand/{brandAbbreviation}/omail/deployment/search/* Testing: https://ows.omedastaging.com/webservices/rest/brand/{brandAbbreviation}/omail/deployment/search/*

brandAbbreviationis the abbreviation for the brand

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-typea 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.JSONapplication/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:POSTSee W3C’s POSTspecs for details.

Field Definition

The following table describes the hierarchical data elements.

Search Elements Submitted

Element Name

Required?

Data Type

Description

Element Name

Required?

Data Type

Description

DeploymentName

optional

string

Text match for deployment name.

TrackId

optional

string

Text match for deployment trackId.

EnteredByOrAssignedTo

optional

string

Text match for user. Matches both the deployment Owner and the deployment creator. In the case of API deployments, the owner and the creator will be the same user.

DeploymentDateStart

optional

string

Deployments have been sent after this date. Format: ‘yyyy-MM-dd HH:mm’, Ex. 2012-01-03 09:30.

DeploymentDateEnd

optional

string

Deployments have been sent prior to this date. Format: ‘yyyy-MM-dd HH:mm’, Ex. 2012-02-03 21:30.

Statuses

optional

array

An array of internal Omail deployment statuses. Valid submission statuses are: ‘NEW’,’SENT_OR_SENDING’, ‘SCHEDULED’, ‘SENDING’, ‘SENT’, ‘CANCELLED’, ‘WAITING_REVIEW’. Values other than these will be ignored by the API.

DeploymentDesignations

optional

array

An array of Deployment Designations. Valid values are: ‘Newsletter’,’Webinar’,’Third Party’,’Research’,’Live Conferences’,’Virtual Conferences’, and ‘Marketing’.

NumResults

optional

integer

Maximum number of deployments returned. Max / Default is 200.

Type

optional

integer

The deployment type ID you wish to filter the results by.

Deployment List Elements Returned

Element Name

Required ?

Data Type

Description

Element Name

Required ?

Data Type

Description

Owner

required

string

Omail user who owns the deployment. Generally this is the creator of the deployment.

Status

required

string

The deployment state.

FinalApprover

required

string

Omail account userID specified as the final approver of the deployment.

Url

required

link

Url for the Deployment Lookup Api.

DeploymentTypeId

required

integer

Deployment type id for the deployment.

DeploymentTypeDescription

required

string

The ‘name’ of the deployment type for the deployment. Example: “Digital Newsletters”.

DeploymentDesignation

required

string

The deployment designation.

TrackId

required

string

Omail deployment tracking number.

CreatedDate

required

datetime

Date & time the deployment was created. yyyy-MM-dd HH:mm:ss format. Example: 2010-03-08 21:23:34.

CreatedBy

required

string

Omail account userID that created the deployment.

ScheduledDate

conditional

datetime

Date & time the deployment is scheduled to deploy. yyyy-MM-dd HH:mm:ss format. Example: 2010-03-08 21:23:34.

SentDate

conditional

datetime

Avaialable only if the deployment has been sent. Date & time the deployment was sent. yyyy-MM-dd HH:mm:ss format. Example: 2010-03-08 21:23:34.

DeploymentName

required

string

User-specified deployment name

Request Example #1

This example would search the Omail system for a deployment name containing the letter ‘e’, with TrackId containing the letter ‘e’, with a scheduled date between March. 28th 2012 12:00 AM and April 2nd, 2012 at 11:59 PM, with a status of ‘SENT’ or ‘SENDING’,for deployment whose type is designated as ‘Webinar’ or ‘Newsletter’, with a maximum number of results returned being 50.

{ "DeploymentName": "e", "TrackId": "e", "EnteredByOrAssignedTo": "e", "DeploymentDateStart": "2012-03-28 00:00", "DeploymentDateEnd": "2012-04-02 23:59", "Statuses": [ "SENT_OR_SENDING" ], "DeploymentDesignations" : [ "Webinar", "Newsletter" ], "NumResults": 50 }

Request Example #2

This would be the search object for searching the top 50 most recent deployments that have a status of sent.

It is important to note that if a field is not included in the search JSON, then the field is not included as part of the search. For instance, in this example, “DeploymentDateStart” and “DeploymentDateEnd” were not included in the search JSON. This means that the search will not be restricted by the date the deployment was sent.

{ "Statuses": [ "SENT" ], "NumResults": 50 }

Response Example

JSON Example

Failed Submission

A failed POST submission may be due to several factors:

Status

Description

Status

Description

400 Bad Request

Typically, this error occurs when the request does not follow the specifications. In the case of an update, this can occur if an HTTP PUT request is submitted without a TrackId element in the submitted json data.

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 a BrandAbbreviation submitted is not found in our system.

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 (POST) for this request.

This is not an exhaustive list of errors, but common ones. If an error occurs repeatedly, please contact your Omeda representative.

JSON Example