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

# Customer.io Journeys App

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental read is not supported, a full read of the Customer Journeys App instance will be done for each scheduled read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://api.customer.io`.

The Customer Journeys App connector supports writing to and reading from the following objects:

* [activities](https://docs.customer.io/api/app/#operation/listActivities) (read)
* [broadcasts](https://docs.customer.io/api/app/#operation/listBroadcasts) (read)
* [collections](https://docs.customer.io/api/app/#operation/getCollections) (read,create,update)
* [exports](https://docs.customer.io/api/app/#operation/listExports) (read)
* [messages](https://docs.customer.io/api/app/#operation/listMessages) (read)
* [newsletters](https://docs.customer.io/api/app/#operation/listNewsletters) (read)
* [object\_types](https://docs.customer.io/api/app/#operation/getObjectTypes) (read)
* [reporting\_webhooks](https://docs.customer.io/api/app/#operation/listWebhooks) (read,create,update)
* [segments](https://docs.customer.io/api/app/#operation/listSegments) (read,create)
* [sender\_identities](https://docs.customer.io/api/app/#operation/listSenders) (read)
* [snippets](https://docs.customer.io/api/app/#operation/listSnippets) (read,create)
* [subscription\_topics](https://docs.customer.io/api/app/#operation/getTopics) (read)
* [transactional](https://docs.customer.io/api/app/#operation/listTransactional) (read)
* [workspaces](https://docs.customer.io/api/app/#operation/listWorkspaces) (read)

Write-only objects:

* [customer\_exports](https://docs.customer.io/api/app/#operation/exportPeopleData) (create)
* [deliveries\_exports](https://docs.customer.io/api/app/#operation/exportDeliveriesData) (create)
* [imports](https://docs.customer.io/api/app/#operation/import) (create)

### Example integration

To define an integration for Customer.io Journeys App, create a manifest file that looks like this:

```YAML theme={null}
# amp.yaml
specVersion: 1.0.0
integrations:
  - name: customerJourneysApp-integration
    displayName: My Customer.io Journeys App Integration
    provider: customerJourneysApp
    proxy:
      enabled: true
```

## Using the connector

This connector uses API Key auth, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.)

To start integrating with Customer.io Journeys App:

* Create a manifest file like the example above.
* Deploy it using the [amp CLI](/cli/overview).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for an API key.
* Start making [Proxy Calls](/proxy-actions), and Ampersand will automatically attach the API key supplied by the customer. Please note that this connector's base URL is `https://api.customer.io`.

## Creating an API key for Customer.io Journeys App

[Click here](https://customer.io/docs/api/app/#section/Authentication) for more information about generating an API key for Customer.io Journeys App. The UI components will display this link, so that your users can successfully create API keys.
