Jump to

• Request
• Response
• Examples

Create an email header

post

/api/REST/1.0/assets/email/header

Creates an email header that matches the criteria specified by the request body.

Request

Supported Media Types

• application/json

Body ()

The request body defines the details of the email header to be updated.

Root Schema : EmailHeader

Type: object

Title: EmailHeader

Show Source

• body: string
  The email header's html text content.
• createdAt: string
  Read Only: true

  The date and time the email header was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the email header.
• currentStatus: string
  The asset's current status. This is a read-only property.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the email header.
• fieldMerges: array fieldMerges
  A list of associated Field Merges.
• hyperlinks: array hyperlinks
  A list of hyperlinks contained within the asset.
• id: string
  Read Only: true

  Id of the email header. This is a read-only property.
• name: string
  The name of the email header.
• permissions: string
  The permissions for the email header granted to your current instance. This is a read-only property.
• text: string
  The raw text from the "body" parameter.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the email header was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the email header.

{
    "title":"EmailHeader",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property. "
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the email header. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The asset's current status. This is a read-only property."
        },
        "name":{
            "type":"string",
            "description":"The name of the email header."
        },
        "description":{
            "type":"string",
            "description":"The description of the email header."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the email header granted to your current instance. This is a read-only property."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the email header."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the email header was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the email header."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the email header was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "body":{
            "type":"string",
            "description":"The email header's html text content."
        },
        "text":{
            "type":"string",
            "description":"The raw text from the \"body\" parameter."
        },
        "fieldMerges":{
            "type":"array",
            "description":"A list of associated Field Merges.",
            "items":{
                "$ref":"#/definitions/FieldMergeRest10"
            }
        },
        "hyperlinks":{
            "type":"array",
            "description":"A list of hyperlinks contained within the asset.",
            "items":{
                "$ref":"#/definitions/HyperlinkRest10"
            }
        }
    }
}

Nested Schema : fieldMerges

Type: array

A list of associated Field Merges.

Show Source

• Array of: object FieldMerge
  Title: FieldMerge

{
    "type":"array",
    "description":"A list of associated Field Merges.",
    "items":{
        "$ref":"#/definitions/FieldMergeRest10"
    }
}

Nested Schema : hyperlinks

Type: array

A list of hyperlinks contained within the asset.

Show Source

• Array of: object Hyperlink
  Title: Hyperlink

{
    "type":"array",
    "description":"A list of hyperlinks contained within the asset.",
    "items":{
        "$ref":"#/definitions/HyperlinkRest10"
    }
}

Nested Schema : FieldMerge

Type: object

Title: FieldMerge

Show Source

• accountFieldId: string
  Id of the associated account field.
• contactFieldId: string
  Id of the associated contact field.
• createdAt: string
  Read Only: true

  The date and time the field merge was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the field merge.
• currentStatus: string
  The field merge's current status.
• defaultValue: string
  The default value of the field merge.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the field merge.
• eventFieldId: string
  Id of the associated event field.
• eventId: string
  Id of the associated event.
• eventSessionFieldId: string
  Id of the associated event session field.
• id: string
  Read Only: true

  Id of the field merge. This is a read-only property.
• mergeType: string
  Type of the field merge. Possible values include: contactField, accountField, eventField, eventSessionField, and customObjectField.
• name: string
  Name of the field merge.
• permissions: string
  The permissions for the field merge granted to your current instance.
• syntax: string
  The syntax of the field merge.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the field merge was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the field merge.

{
    "title":"FieldMerge",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the field merge. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The field merge's current status."
        },
        "name":{
            "type":"string",
            "description":"Name of the field merge."
        },
        "description":{
            "type":"string",
            "description":"The description of the field merge."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the field merge granted to your current instance."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the field merge."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the field merge was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the field merge."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the field merge was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "syntax":{
            "type":"string",
            "description":"The syntax of the field merge."
        },
        "defaultValue":{
            "type":"string",
            "description":"The default value of the field merge."
        },
        "contactFieldId":{
            "type":"string",
            "description":"Id of the associated contact field."
        },
        "accountFieldId":{
            "type":"string",
            "description":"Id of the associated account field."
        },
        "eventId":{
            "type":"string",
            "description":"Id of the associated event."
        },
        "eventFieldId":{
            "type":"string",
            "description":"Id of the associated event field."
        },
        "eventSessionFieldId":{
            "type":"string",
            "description":"Id of the associated event session field."
        },
        "mergeType":{
            "type":"string",
            "description":"Type of the field merge. Possible values include: <code>contactField</code>, <code>accountField</code>, <code>eventField</code>, <code>eventSessionField</code>, and <code>customObjectField</code>."
        }
    }
}

Nested Schema : Hyperlink

Type: object

Title: Hyperlink

Show Source

• createdAt: string
  Read Only: true

  The date and time the hyperlink was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the hyperlink.
• currentStatus: string
  The hyperlink's current status.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the hyperlink.
• href: string
  Href value of the hyperlink.
• hyperlinkType: string
  The type of hyperlink. Possible values include: ExternalURL, ICSCalendarURL, LandingPageURL, ReferrerURL, RSSURL, or TrackedExternalURL.
• id: string
  Read Only: true

  Id of the hyperlink. This is a read-only property.
• name: string
  Name of the hyperlink.
• permissions: string
  The permissions for the hyperlink granted to your current instance.
• referencedEntityId: string
  Id of the referenced entity.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the hyperlink was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the hyperlink.

{
    "title":"Hyperlink",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the hyperlink. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The hyperlink's current status."
        },
        "name":{
            "type":"string",
            "description":"Name of the hyperlink."
        },
        "description":{
            "type":"string",
            "description":"The description of the hyperlink."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the hyperlink granted to your current instance."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the hyperlink."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the hyperlink was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the hyperlink."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the hyperlink was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "href":{
            "type":"string",
            "description":"Href value of the hyperlink."
        },
        "hyperlinkType":{
            "type":"string",
            "description":"The type of hyperlink. Possible values include: ExternalURL, ICSCalendarURL, LandingPageURL, ReferrerURL, RSSURL, or TrackedExternalURL."
        },
        "referencedEntityId":{
            "type":"string",
            "description":"Id of the referenced entity."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

201 Response

Success

Body ()

Root Schema : EmailHeader

Type: object

Title: EmailHeader

Show Source

• body: string
  The email header's html text content.
• createdAt: string
  Read Only: true

  The date and time the email header was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the email header.
• currentStatus: string
  The asset's current status. This is a read-only property.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the email header.
• fieldMerges: array fieldMerges
  A list of associated Field Merges.
• hyperlinks: array hyperlinks
  A list of hyperlinks contained within the asset.
• id: string
  Read Only: true

  Id of the email header. This is a read-only property.
• name: string
  The name of the email header.
• permissions: string
  The permissions for the email header granted to your current instance. This is a read-only property.
• text: string
  The raw text from the "body" parameter.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the email header was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the email header.

{
    "title":"EmailHeader",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property. "
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the email header. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The asset's current status. This is a read-only property."
        },
        "name":{
            "type":"string",
            "description":"The name of the email header."
        },
        "description":{
            "type":"string",
            "description":"The description of the email header."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the email header granted to your current instance. This is a read-only property."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the email header."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the email header was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the email header."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the email header was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "body":{
            "type":"string",
            "description":"The email header's html text content."
        },
        "text":{
            "type":"string",
            "description":"The raw text from the \"body\" parameter."
        },
        "fieldMerges":{
            "type":"array",
            "description":"A list of associated Field Merges.",
            "items":{
                "$ref":"#/definitions/FieldMergeRest10"
            }
        },
        "hyperlinks":{
            "type":"array",
            "description":"A list of hyperlinks contained within the asset.",
            "items":{
                "$ref":"#/definitions/HyperlinkRest10"
            }
        }
    }
}

Nested Schema : fieldMerges

Type: array

A list of associated Field Merges.

Show Source

• Array of: object FieldMerge
  Title: FieldMerge

{
    "type":"array",
    "description":"A list of associated Field Merges.",
    "items":{
        "$ref":"#/definitions/FieldMergeRest10"
    }
}

Nested Schema : hyperlinks

Type: array

A list of hyperlinks contained within the asset.

Show Source

• Array of: object Hyperlink
  Title: Hyperlink

{
    "type":"array",
    "description":"A list of hyperlinks contained within the asset.",
    "items":{
        "$ref":"#/definitions/HyperlinkRest10"
    }
}

Nested Schema : FieldMerge

Type: object

Title: FieldMerge

Show Source

• accountFieldId: string
  Id of the associated account field.
• contactFieldId: string
  Id of the associated contact field.
• createdAt: string
  Read Only: true

  The date and time the field merge was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the field merge.
• currentStatus: string
  The field merge's current status.
• defaultValue: string
  The default value of the field merge.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the field merge.
• eventFieldId: string
  Id of the associated event field.
• eventId: string
  Id of the associated event.
• eventSessionFieldId: string
  Id of the associated event session field.
• id: string
  Read Only: true

  Id of the field merge. This is a read-only property.
• mergeType: string
  Type of the field merge. Possible values include: contactField, accountField, eventField, eventSessionField, and customObjectField.
• name: string
  Name of the field merge.
• permissions: string
  The permissions for the field merge granted to your current instance.
• syntax: string
  The syntax of the field merge.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the field merge was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the field merge.

{
    "title":"FieldMerge",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the field merge. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The field merge's current status."
        },
        "name":{
            "type":"string",
            "description":"Name of the field merge."
        },
        "description":{
            "type":"string",
            "description":"The description of the field merge."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the field merge granted to your current instance."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the field merge."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the field merge was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the field merge."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the field merge was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "syntax":{
            "type":"string",
            "description":"The syntax of the field merge."
        },
        "defaultValue":{
            "type":"string",
            "description":"The default value of the field merge."
        },
        "contactFieldId":{
            "type":"string",
            "description":"Id of the associated contact field."
        },
        "accountFieldId":{
            "type":"string",
            "description":"Id of the associated account field."
        },
        "eventId":{
            "type":"string",
            "description":"Id of the associated event."
        },
        "eventFieldId":{
            "type":"string",
            "description":"Id of the associated event field."
        },
        "eventSessionFieldId":{
            "type":"string",
            "description":"Id of the associated event session field."
        },
        "mergeType":{
            "type":"string",
            "description":"Type of the field merge. Possible values include: <code>contactField</code>, <code>accountField</code>, <code>eventField</code>, <code>eventSessionField</code>, and <code>customObjectField</code>."
        }
    }
}

Nested Schema : Hyperlink

Type: object

Title: Hyperlink

Show Source

• createdAt: string
  Read Only: true

  The date and time the hyperlink was created, expressed in Unix time.
• createdBy: string
  Read Only: true

  The login id of the user who created the hyperlink.
• currentStatus: string
  The hyperlink's current status.
• depth: string
  Read Only: true

  Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: minimal, partial, and complete. Any other values passed are reset to complete by default. For more information, see Request depth.
• description: string
  The description of the hyperlink.
• href: string
  Href value of the hyperlink.
• hyperlinkType: string
  The type of hyperlink. Possible values include: ExternalURL, ICSCalendarURL, LandingPageURL, ReferrerURL, RSSURL, or TrackedExternalURL.
• id: string
  Read Only: true

  Id of the hyperlink. This is a read-only property.
• name: string
  Name of the hyperlink.
• permissions: string
  The permissions for the hyperlink granted to your current instance.
• referencedEntityId: string
  Id of the referenced entity.
• type: string
  The asset's type in Eloqua. This is a read-only property.
• updatedAt: string
  Read Only: true

  Unix timestamp for the date and time the hyperlink was last updated.
• updatedBy: string
  Read Only: true

  The login id of the user that last updated the hyperlink.

{
    "title":"Hyperlink",
    "properties":{
        "type":{
            "type":"string",
            "description":"The asset's type in Eloqua. This is a read-only property."
        },
        "id":{
            "type":"string",
            "readOnly":true,
            "description":"Id of the hyperlink. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The hyperlink's current status."
        },
        "name":{
            "type":"string",
            "description":"Name of the hyperlink."
        },
        "description":{
            "type":"string",
            "description":"The description of the hyperlink."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the hyperlink granted to your current instance."
        },
        "createdBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user who created the hyperlink."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the hyperlink was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the hyperlink."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the hyperlink was last updated."
        },
        "depth":{
            "type":"string",
            "readOnly":true,
            "description":"Level of detail returned by the request. Eloqua APIs can retrieve entities at three different levels of depth: <code>minimal</code>, <code>partial</code>, and <code>complete</code>. Any other values passed are reset to <code>complete</code> by default. For more information, see <a href='https://docs.oracle.com/cloud/latest/marketingcs_gs/OMCAB/index.html#CSHID=RequestDepth'>Request depth</a>."
        },
        "href":{
            "type":"string",
            "description":"Href value of the hyperlink."
        },
        "hyperlinkType":{
            "type":"string",
            "description":"The type of hyperlink. Possible values include: ExternalURL, ICSCalendarURL, LandingPageURL, ReferrerURL, RSSURL, or TrackedExternalURL."
        },
        "referencedEntityId":{
            "type":"string",
            "description":"Id of the referenced entity."
        }
    }
}

400 Response

Bad request. See Status Codes for information about other possible HTTP status codes.

401 Response

Unauthorized. See Status Codes for information about other possible HTTP status codes.

403 Response

Forbidden. See Status Codes for information about other possible HTTP status codes.

404 Response

The requested resource was not found. See Status Codes for information about other possible HTTP status codes.

500 Response

The service has encountered an error. See Status Codes for information about other possible HTTP status codes.

Back to Top

Examples

Create a new email header:

POST /api/REST/1.0/assets/email/header
Content-Type: application/json 
			

Request body:

{
    "name":"Test Header",
    "body":"<p>Here is some text.</p>"
}
			

Response:

{
    "type":"EmailHeader",
    "id":"10",
    "createdAt":"1432563533",
    "createdBy":"19",
    "depth":"complete",
    "folderId":"314",
    "name":"Test Header",
    "permissions":"fullControl",
    "updatedAt":"1432563533",
    "updatedBy":"19",
    "body":"<p>Here is some text.</p>",
    "fieldMerges":[

    ],
    "hyperlinks":[

    ],
    "text":"Here is some text."
}
			

Back to Top