Jump to

• Request
• Response
• Examples

Create an email footer

post

/api/REST/1.0/assets/email/footer

Creates an email footer 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 footer to be created.

Root Schema : EmailFooter

Type: object

Title: EmailFooter

Show Source

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

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

  The login id of the user who created the email footer.
• currentStatus: string
  The email footer'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 email footer.
• fieldMerges: array fieldMerges
  A list of associated Field Merges.
• hyperlinks: array hyperlinks
  A list of hyperlinks contained within the email footer.
• id: string
  Read Only: true

  Id of the email footer. This is a read-only property.
• name: string
  The name of the email footer.
• permissions: string
  The permissions for the email footer 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 footer was last updated.
• updatedBy: string
  Read Only: true

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

{
    "title":"EmailFooter",
    "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 footer. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The email footer's current status."
        },
        "name":{
            "type":"string",
            "description":"The name of the email footer."
        },
        "description":{
            "type":"string",
            "description":"The description of the email footer."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the email footer 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 footer."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the email footer was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the email footer."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the email footer 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 footers'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 email footer.",
            "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 email footer.

Show Source

• Array of: object Hyperlink
  Title: Hyperlink

{
    "type":"array",
    "description":"A list of hyperlinks contained within the email footer.",
    "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 : EmailFooter

Type: object

Title: EmailFooter

Show Source

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

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

  The login id of the user who created the email footer.
• currentStatus: string
  The email footer'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 email footer.
• fieldMerges: array fieldMerges
  A list of associated Field Merges.
• hyperlinks: array hyperlinks
  A list of hyperlinks contained within the email footer.
• id: string
  Read Only: true

  Id of the email footer. This is a read-only property.
• name: string
  The name of the email footer.
• permissions: string
  The permissions for the email footer 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 footer was last updated.
• updatedBy: string
  Read Only: true

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

{
    "title":"EmailFooter",
    "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 footer. This is a read-only property."
        },
        "currentStatus":{
            "type":"string",
            "description":"The email footer's current status."
        },
        "name":{
            "type":"string",
            "description":"The name of the email footer."
        },
        "description":{
            "type":"string",
            "description":"The description of the email footer."
        },
        "permissions":{
            "type":"string",
            "description":"The permissions for the email footer 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 footer."
        },
        "createdAt":{
            "type":"string",
            "readOnly":true,
            "description":"The date and time the email footer was created, expressed in Unix time."
        },
        "updatedBy":{
            "type":"string",
            "readOnly":true,
            "description":"The login id of the user that last updated the email footer."
        },
        "updatedAt":{
            "type":"string",
            "readOnly":true,
            "description":"Unix timestamp for the date and time the email footer 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 footers'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 email footer.",
            "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 email footer.

Show Source

• Array of: object Hyperlink
  Title: Hyperlink

{
    "type":"array",
    "description":"A list of hyperlinks contained within the email footer.",
    "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 footer:

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

Request body:

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

Response:

{
    "type": "EmailFooter",
    "id": "13",
    "createdAt": "1469450883",
    "createdBy": "9",
    "depth": "complete",
    "folderId": "1271",
    "name": "Test Footer",
    "permissions": "fullControl",
    "updatedAt": "1469450883",
    "updatedBy": "9",
    "body": "<p>Here is some text.</p>",
    "fieldMerges": [],
    "hyperlinks": [],
    "text": "\r\nHere is some text.\r\n\r\n"
}
			

Back to Top