> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morph-data.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp

## Connecting to Mailchimp

For an overview of connectors, please refer to the following link:

* [Connecting to DB/SaaS](/docs/en/develop/guides/integration)

<Tabs>
  <Tab title="Dashboard">
    <Steps>
      <Step title="Create a Connector">
        Select the "Connectors" tab on the top page and press the "Create" button.

        <img src="https://mintcdn.com/queue-4c50ebb3/evgQaQjX53Vch8Y5/assets/images/docs/advanced/connectors/connect-data-platform-connection.png?fit=max&auto=format&n=evgQaQjX53Vch8Y5&q=85&s=19c6e7afc70da565c2a8ab4f75469549" alt="Connection" width="1907" height="711" data-path="assets/images/docs/advanced/connectors/connect-data-platform-connection.png" />
      </Step>

      <Step title="Enter Mailchimp Credentials">
        Select Mailchimp and press the sign-in button.

        <img src="https://mintcdn.com/queue-4c50ebb3/evgQaQjX53Vch8Y5/assets/images/docs/advanced/connectors/connect-data-platform-mailchimp-create.png?fit=max&auto=format&n=evgQaQjX53Vch8Y5&q=85&s=b097ec2d4cd565661b8f96ffd18ff553" alt="Mailchimp Connection Create" width="1689" height="786" data-path="assets/images/docs/advanced/connectors/connect-data-platform-mailchimp-create.png" />

        After entering the information, press the Create button to complete the creation. If there are any errors in the parameters, an error message will be displayed, so please check the connection details again.
      </Step>

      <Step title="Retrieve access_token from the Created Connector">
        Once the creation is successful, you can retrieve the connector name from the list.

        Use the dedicated function to input the connector name in the Python code and retrieve the access\_token.

        <CodeGroup>
          ```python Python theme={"dark"}
          import morph
          from morph import MorphGlobalContext
          from morph_lib.api import get_auth_token


          @morph.func
          def main(context: MorphGlobalContext):
              access_token = get_auth_token("connection_name")
              # ↓↓↓ Process using access_token ↓↓↓
          ```
        </CodeGroup>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Local Version">
    <Info>In the local version, you need to directly write the credentials in `~/.morph/connections.yml`. For other methods, please create them in the dashboard.</Info>

    <Steps>
      <Step title="Edit connections.yml">
        If the file does not exist in `~/.morph/connections.yml`, create it beforehand and then edit it.

        ```bash shell theme={"dark"}
        mkdir ~/.morph
        touch ~/.morph/connections.yml
        ```

        ```yaml theme={"dark"}
        connections:
          mailchimp-connection: # Unique arbitrary name
            type: mailchimp # Fixed
            method: mailchimp_oauth # Fixed
            refresh_token: str
            client_id: str
            client_secret: str
            redirect_uri: str
            access_token: str # Optional
        ```
      </Step>

      <Step title="Use the Connector in Code to Retrieve Data">
        Use the dedicated function to input the connector name in the Python code and retrieve the access\_token.

        <CodeGroup>
          ```python Python theme={"dark"}
          import morph
          from morph import MorphGlobalContext
          from morph_lib.api import get_auth_token


          @morph.func
          def main(context: MorphGlobalContext):
              access_token = get_auth_token("connection_name")
              # ↓↓↓ Process using access_token ↓↓↓
          ```
        </CodeGroup>
      </Step>
    </Steps>

    The refresh of the access\_token is a dashboard feature, so the one specified in the local environment will always be used.

    <Warning>
      When actually specifying a connector and executing the file, the priority is as follows:
      Also, please note that only connectors created in the dashboard can be used in environments where `morph deploy` has been performed.

      1. Connectors specified in `~/.morph/connections.yml` on the local machine
      2. Connectors registered in the cloud
    </Warning>
  </Tab>
</Tabs>