Skip to content
EmailShepherdEmailShepherdDocumentation

Get Email Content

GET
/api/v1/workspaces/{workspace_id}/emails/{id}/content
curl --request GET \
  --url https://example.com/%7B%7Bapp_url%7D/api/v1/workspaces/1/emails/1/content \
  --header 'Authorization: Bearer <token>'

Retrieves an email’s content.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
workspace_id
required
integer

Workspace ID

id
required
integer

Email ID

Responses

Section titled “ Responses ”

200

Section titled “200”

Successful

Media typeapplication/json
object
subject
required
object
conditional_id

The ID of a saved conditional applied to this content. When set, inline_conditional must not be set. The content has a separate variant for each branch of the conditional.

integer | null
inline_conditional
One of:

A conditional definition owned by a single component instance in an email.

object
default_syntax
required
object
closing
required

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branches
required
Array<object>
object
key
required
string
label
required
string
dynamic_content_profile_syntaxes
required
object
key
additional properties

A per-DynamicContentProfile syntax entry on a Conditional.

object
closing

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branch_content
required

Content organized by branch key, then by locale code.

object
key
additional properties

Localized email subject, keyed by BCP47 locale

object
key
additional properties
string
preheader
required
object
conditional_id

The ID of a saved conditional applied to this content. When set, inline_conditional must not be set. The content has a separate variant for each branch of the conditional.

integer | null
inline_conditional
One of:

A conditional definition owned by a single component instance in an email.

object
default_syntax
required
object
closing
required

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branches
required
Array<object>
object
key
required
string
label
required
string
dynamic_content_profile_syntaxes
required
object
key
additional properties

A per-DynamicContentProfile syntax entry on a Conditional.

object
closing

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branch_content
required

Content organized by branch key, then by locale code.

object
key
additional properties

Localized email preheader, keyed by BCP47 locale

object
key
additional properties
string
container_component_instance
required
object
id
required
string format: uuid
name
string
component_name
required

The name of the component definition this instance is based on.

string
conditional_id

The ID of a saved conditional applied to this component instance. When set, inline_conditional must not be set. The component renders a separate variant for each branch of the conditional.

integer | null
inline_conditional
One of:

A conditional definition owned by a single component instance in an email.

object
default_syntax
required
object
closing
required

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branches
required
Array<object>
object
key
required
string
label
required
string
dynamic_content_profile_syntaxes
required
object
key
additional properties

A per-DynamicContentProfile syntax entry on a Conditional.

object
closing

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
field_values

Field values organized by branch key.

object
key
additional properties

Field values organized by locale code.

object
key
additional properties

Field values keyed by liquid variable name.

object
key
additional properties
object
value
required
One of:
string
link_tracking_parameters

Link tracking parameter values specific to this field.

object
key
additional properties
string
hidden_from_locales

A map of locale codes to boolean values indicating whether this component instance is hidden for that locale.

object
key
additional properties
boolean
link_tracking_parameters
object
branch_content

Per-component-instance link tracking parameter values, organized by branch key, then by locale code.

object
key
additional properties
object
key
additional properties

A map of link tracking parameter names to their values for this component instance.

object
key
additional properties
string
component_instances
required
Array<object>
object
id
required
string format: uuid
name
string
component_name
required

The name of the component definition this instance is based on.

string
conditional_id

The ID of a saved conditional applied to this component instance. When set, inline_conditional must not be set. The component renders a separate variant for each branch of the conditional.

integer | null
inline_conditional
One of:

A conditional definition owned by a single component instance in an email.

object
default_syntax
required
object
closing
required

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
branches
required
Array<object>
object
key
required
string
label
required
string
dynamic_content_profile_syntaxes
required
object
key
additional properties

A per-DynamicContentProfile syntax entry on a Conditional.

object
closing

The closing syntax tag for the conditional block.

string
branch_values

Key-value pairs where the key is the branch key and the value is the opening syntax for that branch.

object
key
additional properties
string
field_values

Field values organized by branch key.

object
key
additional properties

Field values organized by locale code.

object
key
additional properties

Field values keyed by liquid variable name.

object
key
additional properties
object
value
required
One of:
string
link_tracking_parameters

Link tracking parameter values specific to this field.

object
key
additional properties
string
hidden_from_locales

A map of locale codes to boolean values indicating whether this component instance is hidden for that locale.

object
key
additional properties
boolean
link_tracking_parameters
object
branch_content

Per-component-instance link tracking parameter values, organized by branch key, then by locale code.

object
key
additional properties
object
key
additional properties

A map of link tracking parameter names to their values for this component instance.

object
key
additional properties
string
global_link_tracking_parameters

A map of link tracking parameter names to their values for this component instance.

object
key
additional properties
string
Example
{
  "subject": {
    "inline_conditional": {
      "default_syntax": {
        "closing": "{% endif %}",
        "branch_values": {
          "gold_membership": "{% if membership == 'gold' %}",
          "silver_membership": "{% elsif membership == 'silver' %}"
        }
      },
      "branches": [
        {
          "key": "gold_membership",
          "label": "Gold Membership"
        }
      ],
      "dynamic_content_profile_syntaxes": {
        "additionalProperty": {
          "closing": "{% endif %}",
          "branch_values": {
            "gold_membership": "{% if membership == 'gold' %}",
            "silver_membership": "{% elsif membership == 'silver' %}"
          }
        }
      }
    },
    "branch_content": {
      "additionalProperty": {
        "additionalProperty": "My Email Subject in a Specific Locale"
      }
    }
  },
  "preheader": {
    "inline_conditional": {
      "default_syntax": {
        "closing": "{% endif %}",
        "branch_values": {
          "gold_membership": "{% if membership == 'gold' %}",
          "silver_membership": "{% elsif membership == 'silver' %}"
        }
      },
      "branches": [
        {
          "key": "gold_membership",
          "label": "Gold Membership"
        }
      ],
      "dynamic_content_profile_syntaxes": {
        "additionalProperty": {
          "closing": "{% endif %}",
          "branch_values": {
            "gold_membership": "{% if membership == 'gold' %}",
            "silver_membership": "{% elsif membership == 'silver' %}"
          }
        }
      }
    },
    "branch_content": {
      "additionalProperty": {
        "additionalProperty": "My Email Preheader in a Specific Locale"
      }
    }
  },
  "container_component_instance": {
    "id": "bd1c1b82-1a7b-4f0f-b079-30c1d4189bed",
    "name": "My Component",
    "component_name": "Headline",
    "conditional_id": 1,
    "inline_conditional": {
      "default_syntax": {
        "closing": "{% endif %}",
        "branch_values": {
          "gold_membership": "{% if membership == 'gold' %}",
          "silver_membership": "{% elsif membership == 'silver' %}"
        }
      },
      "branches": [
        {
          "key": "gold_membership",
          "label": "Gold Membership"
        }
      ],
      "dynamic_content_profile_syntaxes": {
        "additionalProperty": {
          "closing": "{% endif %}",
          "branch_values": {
            "gold_membership": "{% if membership == 'gold' %}",
            "silver_membership": "{% elsif membership == 'silver' %}"
          }
        }
      }
    },
    "hidden_from_locales": {
      "additionalProperty": true
    }
  },
  "component_instances": [
    {
      "id": "bd1c1b82-1a7b-4f0f-b079-30c1d4189bed",
      "name": "My Component",
      "component_name": "Headline",
      "conditional_id": 1,
      "inline_conditional": {
        "default_syntax": {
          "closing": "{% endif %}",
          "branch_values": {
            "gold_membership": "{% if membership == 'gold' %}",
            "silver_membership": "{% elsif membership == 'silver' %}"
          }
        },
        "branches": [
          {
            "key": "gold_membership",
            "label": "Gold Membership"
          }
        ],
        "dynamic_content_profile_syntaxes": {
          "additionalProperty": {
            "closing": "{% endif %}",
            "branch_values": {
              "gold_membership": "{% if membership == 'gold' %}",
              "silver_membership": "{% elsif membership == 'silver' %}"
            }
          }
        }
      },
      "hidden_from_locales": {
        "additionalProperty": true
      }
    }
  ]
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
message
required
string
code
string
Example
{
  "message": "Record not found",
  "code": "share_link_expired"
}

403

Section titled “403”

Forbidden

Media typeapplication/json
object
message
required
string
code
string
Example
{
  "message": "Record not found",
  "code": "share_link_expired"
}

404

Section titled “404”

Not Found

Media typeapplication/json
object
message
required
string
code
string
Example
{
  "message": "Record not found",
  "code": "share_link_expired"
}