---
title: "Get automation info"
method: GET
path: "/3.0/automations/{workflow_id}"
tags: ["automations"]
---

# Get automation info

`GET /3.0/automations/{workflow_id}`

## Request

- Base URL: `https://api.mailchimp.com`
- URL: `https://api.mailchimp.com/3.0/automations/{workflow_id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://login.mailchimp.com/oauth2/authorize`
    - Token URL: `https://login.mailchimp.com/oauth2/token`
- TypeScript: <https://skmtc.dev/mailchimp/apis/mailchimp-api/docs/3.0/automations/:workflow_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get a summary of an individual classic automation workflow's settings and content. The `trigger_settings` object returns information for the first email in the workflow.

## Path parameters

- `workflow_id` string, required

## Query parameters

- `fields` string[]
- `exclude_fields` string[]

## Response `200`

- object: A summary of an individual Automation workflow's settings and content.
  - `_links` object[]: A list of link types and descriptions for the API schema documents.
    - `href` string: This property contains a fully-qualified URL that can be called to retrieve the linked resource or perform the linked action.
    - `method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD': The HTTP method that should be used when accessing the URL defined in 'href'.
    - `rel` string: As with an HTML 'rel' attribute, this describes the type of link.
    - `schema` string: For HTTP methods that can receive bodies (POST and PUT), this is a URL representing the schema that the body should conform to.
    - `targetSchema` string: For GETs, this is a URL representing the schema that the response should conform to.
  - `create_time` string, date-time: The date and time the Automation was created in ISO 8601 format.
  - `emails_sent` integer: The total number of emails sent for the Automation.
  - `id` string: A string that identifies the Automation.
  - `recipients` object: List settings for the Automation.
    - `list_id` string: The unique list id.
    - `list_is_active` boolean: The status of the list used, namely if it's deleted or disabled.
    - `list_name` string: List Name.
    - `segment_opts` union[]: Segment match conditions. There are multiple possible types, see the [condition types documentation](https://mailchimp.com/developer/marketing/docs/alternative-schemas/#segment-condition-schemas).
      - union
        - object: Segment by interaction with a specific campaign.
          - `condition_type` 'Aim'
          - `field` 'aim': Segment by interaction with a specific campaign.
          - `op` 'open' | 'click' | 'sent' | 'noopen' | 'noclick' | 'nosent': The status of the member with regard to their campaign interaction. One of the following: opened, clicked, was sent, didn't open, didn't click, or was not sent.
          - `value` string: Either the web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.
        - object: Segment by interaction with an Automation workflow.
          - `condition_type` 'Automation'
          - `field` 'automation', required: Segment by interaction with an Automation workflow.
          - `op` 'started' | 'completed' | 'not_started' | 'not_completed', required: The status of the member with regard to the automation workflow. One of the following: has started the workflow, has completed the workflow, has not started the workflow, or has not completed the workflow.
          - `value` string, required: The web id for the automation workflow to segment against.
        - object: Segment by poll activity.
          - `condition_type` 'CampaignPoll'
          - `field` 'poll', required: Segment by poll activity.
          - `op` 'member' | 'notmember', required: Members have/have not interacted with a specific poll in a Mailchimp email.
          - `value` number, required: The id for the poll.
        - object: Segment by interaction with a campaign via Conversations.
          - `condition_type` 'Conversation'
          - `field` 'conversation', required: Segment by interaction with a campaign via Conversations.
          - `op` 'member' | 'notmember', required: The status of a member's interaction with a conversation. One of the following: has replied or has not replied.
          - `value` string, required: The web id value for a specific campaign or 'any' to account for subscribers who have/have not interacted with any campaigns.
        - object: Segment by a specific date field.
          - `condition_type` 'Date'
          - `extra` string: When segmenting on 'date' or 'campaign', the date for the segment formatted as YYYY-MM-DD or the web id for the campaign.
          - `field` 'timestamp_opt' | 'info_changed' | 'ecomm_date', required: The type of date field to segment on: The opt-in time for a signup, the date the subscriber was last updated, or the date of their last ecomm purchase.
          - `op` 'greater' | 'less' | 'is' | 'not' | 'blank' | 'blank_not' | 'within' | 'notwithin', required: When the event took place: Before, after, is a specific date, is not a specific date, is blank, or is not blank.
          - `value` string, required: What type of data to segment on: a specific date, a specific campaign, or the last campaign sent.
        - object: Segment by use of a particular email client.
          - `condition_type` 'EmailClient'
          - `field` 'email_client', required: Segment by use of a particular email client.
          - `op` 'client_is' | 'client_not', required: The operation to determine whether we select clients that match the value, or clients that do not match the value.
          - `value` string, required: The name of the email client.
        - object: Segment by language.
          - `condition_type` 'Language'
          - `field` 'language', required: Segmenting based off of a subscriber's language.
          - `op` 'is' | 'not', required: Whether the member's language is or is not set to a specific language.
          - `value` string, required: A two-letter language identifier.
        - object: Segment by member rating.
          - `condition_type` 'MemberRating'
          - `field` 'rating', required: Segment by member rating.
          - `op` 'is' | 'not' | 'greater' | 'less', required: Members who have have a rating that is/not exactly a given number or members who have a rating greater/less than a given number.
          - `value` union, required
            - number
            - string
        - object: Segment by signup source.
          - `condition_type` 'SignupSource', required
          - `field` 'source', required
          - `op` 'source_is' | 'source_not', required: Whether the member's signup source was/was not a particular value.
          - `value` string: The signup source.
        - object: Segment by interaction with a SurveyMonkey survey.
          - `condition_type` 'SurveyMonkey'
          - `field` 'survey_monkey', required: Segment by interaction with a SurveyMonkey survey.
          - `op` 'started' | 'completed' | 'not_started' | 'not_completed', required: The status of the member with regard to the survey.One of the following: has started the survey, has completed the survey, has not started the survey, or has not completed the survey.
          - `value` string, required: The unique ID of the survey monkey survey.
        - object: Segment by VIP status.
          - `condition_type` 'VIP'
          - `field` 'gmonkey', required: Segment by VIP status.
          - `op` 'member' | 'notmember', required: Whether the member is or is not marked as VIP.
        - object: Segment by an interest group merge field.
          - `condition_type` 'Interests'
          - `field` string: Segmenting based on interest group information. This should start with 'interests-' followed by the grouping id. Ex. 'interests-123'.
          - `op` 'interestcontains' | 'interestcontainsall' | 'interestnotcontains': Whether the member is a part of one, all, or none of the groups.
          - `value` string[]: An array containing strings, each representing a group id.
        - object: Segment by purchases in specific items or categories.
          - `condition_type` 'EcommCategory'
          - `field` 'ecomm_cat' | 'ecomm_prod': Segment by purchases in specific items or categories.
          - `op` 'is' | 'not' | 'contains' | 'notcontain' | 'starts' | 'ends': A member who has purchased from a category/specific item that is/is not a specific name, where the category/item name contains/doesn't contain a specific phrase or string, or a category/item name that starts/ends with a string.
          - `value` string: The ecommerce category/item information.
        - object: Segment by average spent total, number of orders, total number of products purchased, or average number of products per order.
          - `condition_type` 'EcommNumber'
          - `field` 'ecomm_spent_avg' | 'ecomm_orders' | 'ecomm_prod_all' | 'ecomm_avg_ord', required: Segment by average spent total, number of orders, total number of products purchased, or average number of products per order.
          - `op` 'is' | 'not' | 'greater' | 'less', required: Members who have spent exactly, have not spent exactly, spent more, or spent less than the segment value.
          - `value` union, required
            - number
            - string
        - object: Segment by whether someone has purchased anything.
          - `condition_type` 'EcommPurchased'
          - `field` 'ecomm_purchased': Segment by whether someone has purchased anything.
          - `op` 'member' | 'notmember': Members who have have ('member') or have not ('notmember') purchased.
        - object: Segment by amount spent on a single order or across all orders.
          - `condition_type` 'EcommSpent'
          - `field` 'ecomm_spent_one' | 'ecomm_spent_all': Segment by amount spent on a single order or across all orders.
          - `op` 'greater' | 'less': Members who have spent 'more' or 'less' than then specified value.
          - `value` union
            - number
            - string
        - object: Segment by purchases from a specific store.
          - `condition_type` 'EcommStore'
          - `field` 'ecomm_store': Segment by purchases from a specific store.
          - `op` 'is' | 'not': Members who have or have not purchased from a specific store.
          - `value` string: The store id to segment against.
        - object: Segment by Goal activity.
          - `condition_type` 'GoalActivity'
          - `field` 'goal', required: Segment by Goal activity.
          - `op` 'is' | 'goal_not' | 'contains' | 'goal_notcontain' | 'starts' | 'ends', required: Whether the website URL is/not exactly, contains/doesn't contain, starts with/ends with a string.
          - `value` string, required: The URL to check Goal activity against.
        - object: Segment by most recent interaction with a website.
          - `condition_type` 'GoalTimestamp'
          - `field` 'goal_last_visited', required: Segment by most recent interaction with a website.
          - `op` 'greater' | 'less' | 'is', required: Whether the website activity happened after, before, or at a given timestamp.
          - `value` string, required: The date to check Goal activity against.
        - object: Segment by similar subscribers.
          - `condition_type` 'FuzzySegment'
          - `field` 'fuzzy_segment', required: Segment by similar subscribers.
          - `op` 'fuzzy_is' | 'fuzzy_not', required: Members who are/are not apart of a 'similar subscribers' segment.
          - `value` union, required
            - number
            - string
        - object: Segment by a given static segment.
          - `condition_type` 'StaticSegment'
          - `field` 'static_segment', required: Segment by a given static segment.
          - `op` 'static_is' | 'static_not', required: Members who are/are not apart of a static segment.
          - `value` union, required
            - number
            - string
        - object: Segment by a specific country or US state.
          - `condition_type` 'IPGeoCountryState'
          - `field` 'ipgeo', required: Segmenting subscribers who are within a specific location.
          - `op` 'ipgeocountry' | 'ipgeonotcountry' | 'ipgeostate' | 'ipgeonotstate', required: Segment members who are within a specific country or US state.
          - `value` string, required: The two-letter country code or US state abbreviation.
        - object: Segment by a specific geographic region.
          - `addr` string, required: The address of the target location.
          - `condition_type` 'IPGeoIn'
          - `field` 'ipgeo', required: Segmenting subscribers who are within a specific location.
          - `lat` string, required: The latitude of the target location.
          - `lng` string, required: The longitude of the target location.
          - `op` 'ipgeoin' | 'ipgeonotin', required: Segment members who are within a specific geographic region.
          - `value` integer, required: The radius of the target location.
        - object: Segment by a specific US ZIP code.
          - `condition_type` 'IPGeoInZip'
          - `extra` integer, required: The zip code to segment against.
          - `field` 'ipgeo', required: Segmenting subscribers who are within a specific location.
          - `op` 'ipgeoinzip', required: Segment members who are within a specific US zip code.
          - `value` integer, required: The radius of the target location.
        - object: Segment members whose location information is unknown.
          - `condition_type` 'IPGeoUnknown'
          - `field` 'ipgeo', required: Segmenting subscribers who are within a specific location.
          - `op` 'ipgeounknown', required: Segment members for which location information is unknown.
        - object: Segment by a specific US ZIP code.
          - `condition_type` 'IPGeoZip'
          - `field` 'ipgeo', required: Segmenting subscribers who are within a specific location.
          - `op` 'ipgeoiszip' | 'ipgeonotzip', required: Segment members who are/are not within a specific US zip code.
          - `value` integer, required: The 5-digit zip code.
        - object: Segment by age ranges in Social Profiles data.
          - `condition_type` 'SocialAge'
          - `field` 'social_age', required: Segment by age ranges in Social Profiles data.
          - `op` 'is' | 'not', required: Members who are/not the exact criteria listed.
          - `value` '18-24' | '25-34' | '35-54' | '55+', required: The age range to segment.
        - object: Segment by listed gender in Social Profiles data.
          - `condition_type` 'SocialGender'
          - `field` 'social_gender', required: Segment by listed gender in Social Profiles data.
          - `op` 'is' | 'not', required: Members who are/not the exact criteria listed.
          - `value` 'male' | 'female', required: The Social Profiles gender to segment.
        - object: Segment by influence rating in Social Profiles data.
          - `condition_type` 'SocialInfluence'
          - `field` 'social_influence', required: Segment by influence rating in Social Profiles data.
          - `op` 'is' | 'not' | 'greater' | 'less', required: Members who have a rating that is/not or greater/less than the rating provided.
          - `value` number, required: The Social Profiles influence rating to segment.
        - object: Segment by social network in Social Profiles data.
          - `condition_type` 'SocialNetworkMember'
          - `field` 'social_network', required: Segment by social network in Social Profiles data.
          - `op` 'member' | 'notmember', required: Members who are/not on a given social network.
          - `value` 'twitter' | 'facebook' | 'linkedin' | 'flickr' | 'foursquare' | 'lastfm' | 'myspace' | 'quora' | 'vimeo' | 'yelp' | 'youtube', required: The social network to segment against.
        - object: Segment by social network in Social Profiles data.
          - `condition_type` 'SocialNetworkFollow'
          - `field` 'social_network', required: Segment by social network in Social Profiles data.
          - `op` 'follow' | 'notfollow', required: Members who are/not following a linked account on a given social network.
          - `value` 'twitter_follow', required: The social network to segment against.
        - object: Segment by an address-type merge field.
          - `condition_type` 'AddressMerge'
          - `field` string, required: An address-type merge field to segment.
          - `op` 'contains' | 'notcontain' | 'blank' | 'blank_not', required: Whether the member's address merge field contains/does not contain a value or is/is not blank.
          - `value` string: The value to segment a text merge field with.
        - object: Segment by an address-type merge field within a given distance.
          - `condition_type` 'ZipMerge'
          - `extra` string, required: The city or the zip being used to segment against.
          - `field` string, required: An address or zip-type merge field to segment.
          - `op` 'geoin', required: Whether the member's address merge field is within a given distance from a city or zip.
          - `value` string, required: The distance from the city/zip.
        - object: Segment by a contact's birthday.
          - `condition_type` 'BirthdayMerge'
          - `field` string, required: A date merge field to segment.
          - `op` 'is' | 'not' | 'blank' | 'blank_not', required: Whether the member's birthday merge information is/is not a certain date or is/is not blank.
          - `value` string: A date to segment against (mm/dd).
        - object: Segment by a given date merge field.
          - `condition_type` 'DateMerge'
          - `field` string, required: A date merge field to segment.
          - `op` 'is' | 'not' | 'less' | 'blank' | 'blank_not' | 'greater', required: Whether the member's merge information is/is not, is greater/less than a value or is/is not blank.
          - `value` string: A date to segment against.
        - object: An individual segment condition
          - `condition_type` 'SelectMerge'
          - `field` string, required: A merge field to segment.
          - `op` 'is' | 'not' | 'blank' | 'blank_not' | 'notcontain' | 'contains', required: Whether the member's merge information is/is not a value or is/is not blank.
          - `value` string: The value to segment a text merge field with.
        - object: Segment by a given text or number merge field.
          - `condition_type` 'TextMerge'
          - `field` string, required: A text or number merge field to segment.
          - `op` 'is' | 'not' | 'contains' | 'notcontain' | 'starts' | 'ends' | 'greater' | 'less' | 'blank' | 'blank_not', required: Whether the member's merge information is/is not, contains/does not contain, starts/ends with, or is greater/less than a value
          - `value` string: The value to segment a text or number merge field with.
        - object: Segment by email address.
          - `condition_type` 'EmailAddress'
          - `field` 'merge0' | 'EMAIL', required: Segmenting based off of a subscriber's email address.
          - `op` 'is' | 'not' | 'contains' | 'notcontain' | 'starts' | 'ends' | 'greater' | 'less', required: Whether the email address is/not exactly, contains/doesn't contain, starts/ends with a string.
          - `value` string: The value to compare the email against.
        - object: Segment by predicted gender.
          - `condition_type` 'PredictedGender'
          - `field` 'predicted_gender', required: Segment by predicted gender.
          - `op` 'is' | 'not', required: Members who are/not the exact criteria listed.
          - `value` 'male' | 'female', required: The predicted gender to segment.
        - object: Segment by predicted age.
          - `condition_type` 'PredictedAge'
          - `field` 'predicted_age_range', required: Segment by predicted age.
          - `op` 'is', required: Members who are/not the exact criteria listed.
          - `value` '18-24' | '25-34' | '35-44' | '45-54' | '55-64' | '65+', required: The predicted age to segment.
        - object: Segment by when people subscribed.
          - `condition_type` 'NewSubscribers'
          - `field` 'timestamp_opt': Segment by when people subscribed.
          - `op` 'date_within': Whe the event took place, namely within a time frame.
          - `value` string: What type of data to segment on: a specific date, a specific campaign, or the last campaign sent.
    - `store_id` string: The id of the store.
  - `report_summary` object: A summary of opens and clicks for sent campaigns.
    - `click_rate` number: The number of unique clicks, divided by the total number of successful deliveries.
    - `clicks` integer: The total number of clicks for an campaign.
    - `open_rate` number: The number of unique opens divided by the total number of successful deliveries.
    - `opens` integer: The total number of opens for a campaign.
    - `subscriber_clicks` integer: The number of unique clicks.
    - `unique_opens` integer: The number of unique opens.
  - `settings` object: The settings for the Automation workflow.
    - `authenticate` boolean: Whether Mailchimp [authenticated](https://mailchimp.com/help/about-email-authentication/) the Automation. Defaults to `true`.
    - `auto_footer` boolean: Whether to automatically append Mailchimp's [default footer](https://mailchimp.com/help/about-campaign-footers/) to the Automation.
    - `from_name` string: The 'from' name for the Automation (not an email address).
    - `inline_css` boolean: Whether to automatically inline the CSS included with the Automation content.
    - `reply_to` string: The reply-to email address for the Automation.
    - `title` string: The title of the Automation.
    - `to_name` string: The Automation's custom 'To' name, typically the first name [audience field](https://mailchimp.com/help/getting-started-with-merge-tags/).
    - `use_conversation` boolean: Whether to use Mailchimp Conversation feature to manage replies
  - `start_time` string, date-time: The date and time the Automation was started in ISO 8601 format.
  - `status` 'save' | 'paused' | 'sending': The current status of the Automation.
  - `tracking` object: The tracking options for the Automation.
    - `capsule` object: Deprecated
      - `notes` boolean: Update contact notes for a campaign based on a subscriber's email addresses.
    - `clicktale` string: The custom slug for [ClickTale](https://mailchimp.com/help/additional-tracking-options-for-campaigns/) tracking (max of 50 bytes).
    - `ecomm360` boolean: Whether to enable e-commerce tracking.
    - `goal_tracking` boolean: Deprecated
    - `google_analytics` string: The custom slug for [Google Analytics](https://mailchimp.com/help/integrate-google-analytics-with-mailchimp/) tracking (max of 50 bytes).
    - `html_clicks` boolean: Whether to [track clicks](https://mailchimp.com/help/enable-and-view-click-tracking/) in the HTML version of the Automation. Defaults to `true`.
    - `opens` boolean: Whether to [track opens](https://mailchimp.com/help/about-open-tracking/). Defaults to `true`.
    - `salesforce` object: Deprecated
      - `campaign` boolean: Create a campaign in a connected Salesforce account.
      - `notes` boolean: Update contact notes for a campaign based on a subscriber's email address.
    - `text_clicks` boolean: Whether to [track clicks](https://mailchimp.com/help/enable-and-view-click-tracking/) in the plain-text version of the Automation. Defaults to `true`.
  - `trigger_settings` object: Available triggers for Automation workflows.
    - `runtime` object: A workflow's runtime settings for an Automation.
      - `days` string[]: The days an Automation workflow can send.
      - `hours` object: The hours an Automation workflow can send.
        - `type` 'send_asap' | 'send_between' | 'send_at', required: When to send the Automation email.
    - `workflow_emails_count` integer: The number of emails in the Automation workflow.
    - `workflow_title` string: The title of the workflow type.
    - `workflow_type` 'abandonedBrowse' | 'abandonedCart' | 'api' | 'bestCustomers' | 'categoryFollowup' | 'dateAdded' | 'emailFollowup' | 'emailSeries' | 'groupAdd' | 'groupRemove' | 'mandrill' | 'productFollowup' | 'purchaseFollowup' | 'recurringEvent' | 'specialEvent' | 'visitUrl' | 'welcomeSeries', required: The type of Automation workflow.

## Other responses

- `default`: An error generated by the Mailchimp API.

---

[API](https://skmtc.dev/mailchimp/apis/mailchimp-api.md) - [All operations](https://skmtc.dev/mailchimp/apis/mailchimp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailchimp/apis/mailchimp-api/revisions/53bf4b156855?raw)