Skip to content

Setting Up Integrations

Configuring Integrations

Cartly's integration engine lets you connect your store with external services using connectors, webhooks, and pre-built templates.

What Are Integrations?

Integrations connect your Cartly store to external services — shipping carriers, email providers, accounting software, ERPs, and more. Unlike apps (which add UI features), integrations work in the background to sync data and automate processes.

Integration Templates

Cartly provides pre-built integration templates for popular services. Templates include pre-configured request chains, authentication flows, and data mappings. Currently available templates include shipping carriers (Shippo, EasyPost) and more are added regularly.

Setting Up a Connector

  1. Navigate to Settings → Integrations
  2. Browse available integration templates or click Create Custom
  3. Select a template and click Install
  4. Enter your API credentials for the external service
  5. Configure the connector settings (endpoints, mappings, etc.)
  6. Test the connection to verify it works
  7. Activate the connector

Connector Configuration

Each connector stores:

  • Credentials — API keys, tokens, or OAuth tokens for the external service (encrypted at rest)
  • Hooks — Named actions that execute request chains in response to store events (e.g., "get_rates" for shipping)
  • Mappings — How data from Cartly maps to the external service's format and vice versa

Webhooks

Cartly can send webhooks to external services when events occur in your store. Navigate to Settings → Webhooks to configure outgoing webhooks. Available events include:

  • Order created, updated, fulfilled
  • Product created, updated, deleted
  • Customer created, updated
  • Inventory updated

Each webhook sends a JSON payload with the event data to your specified URL.

OAuth Integrations

Some integrations use OAuth for secure authentication. When setting up an OAuth integration, you are redirected to the external service to authorize access. Cartly stores the OAuth tokens securely and refreshes them automatically when they expire.

Monitoring Integrations

Each connector tracks its execution history. View recent executions, success/failure rates, and response times in the connector detail page. Failed executions include error messages to help diagnose issues.

Was this helpful?