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

# Customizing Connectors

> Use the StackOne CLI to pull, edit, test, and push changes to an existing connector.

Adapt an existing connector — its actions, fields, and data mappings — by pulling it down with the [StackOne CLI](/connector-building/stackone-cli), editing the YAML, and pushing your changes back.

<Steps>
  <Step title="Install the CLI">
    ```bash theme={null}
    npm install -g @stackone/cli
    ```
  </Step>

  <Step title="Authenticate">
    Set up a profile with your API key. Customizing needs an [API key](/embed/api-keys#scopes) with the `connectors:read` and `connectors:write` scopes.

    ```bash theme={null}
    stackone init
    ```
  </Step>

  <Step title="Pull the connector">
    Download the connector's files to your machine.

    ```bash theme={null}
    stackone pull --connector [provider] --profile [profile-label]
    ```

    Files save to `./connectors/[provider]/` by default. Append a version to pull a specific one, such as `--connector [provider]@1.0.0`, or pass `--output-path` to save elsewhere.
  </Step>

  <Step title="Make your changes">
    Edit `[provider].connector.s1.yaml` to adjust authentication, add or change actions, and map provider fields to your own schema.

    <Card title="Connector YAML Reference" icon="file-code" href="/connector-yaml-reference/overview">
      Every field, step function, and expression the schema supports.
    </Card>
  </Step>

  <Step title="Validate as you edit">
    Check syntax and structure. `--watch` re-runs on every save.

    ```bash theme={null}
    stackone validate ./connectors/[provider]/ --watch
    ```
  </Step>

  <Step title="Test an action">
    Run an action against a linked account to confirm your changes behave as expected.

    ```bash theme={null}
    stackone run \
      --connector [provider].connector.s1.yaml \
      --account-id [account-id] \
      --action-id [action-id]
    ```
  </Step>

  <Step title="Push your changes">
    Upload the updated connector back to StackOne.

    ```bash theme={null}
    stackone push ./connectors/[provider]/ --profile [profile]
    ```
  </Step>
</Steps>

<Card title="CLI Reference" icon="terminal" href="/connector-building/stackone-cli">
  All commands, flags, and test-file formats.
</Card>