Autopilot Destination (Legacy)

Autopilot is a popular marketing automation platform that allows you to track and capture new leads, create detailed customer journeys, and boost customer retention.

This documentation is for the legacy Autopilot destination in RudderStack. Autopilot is now rebranded as Ortto.

Refer to this documentation only if you set up the Autopilot destination in RudderStack before the rebranding, or if you are leveraging the Autopilot REST API to send the data.

See the Ortto destination documentation for more information on using the new Ortto integration.

Find the open source transformer code for this destination in the GitHub repository.

Connection compatibility

Destination Information
Status: Generally Available Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as Autopilot in the Integrations object.

Connection Modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported Message Types
Source	Identify	Page	Track	Screen	Group	Alias	Record
Cloud mode
Supported sources

Setup

1. In your RudderStack dashboard, set up a source.
2. Go to the Overview tab of your source and select Add Destination > Create new destination.

3. Select Autopilot from the list of destinations. Then, click Continue.

Connection settings

Identify

The identify call captures relevant details about the visiting user and creates or updates a contact in Autopilot.

A sample identify call is shown below:

rudderanalytics.identify("user_123", {
  email: "john@example.com",
  firstName: "John",
  lastName: "Doe",
  phone: "+1234567890",
  company: {
    name: "Acme Corp"
  },
  status: "active",
  LeadSource: "website",
  customField: "custom value"
});

Supported fields

RudderStack maps the following identify event traits to the standard Autopilot fields:

RudderStack sends additional traits as custom properties to Autopilot.

Track

You can use the track call to trigger journeys in Autopilot by adding contacts to specific triggers.

To send track events to Autopilot successfully, note that:

• The track event must include an email address in either properties.email or traits.email to identify the contact in Autopilot.
• You must configure a valid Autopilot trigger ID in your destination settings.

Sample track event

rudderanalytics.track("Purchase Completed", {
  email: "john@example.com",
  productId: "prod_123",
  amount: 99.99,
  currency: "USD"
});

API endpoints

RudderStack uses the following API endpoints to send events to Autopilot:

Troubleshooting

This section lists some common issues you may encounter while using this integration and their solutions.

Track events failing with “Email is required” error

If you receive this error, make sure that your track events include an email address. You can provide the email in the following fields:

• properties.email
• traits.email
• context.traits.email

Invalid trigger ID error

If you encounter trigger ID errors:

• Verify that the trigger ID in your destination settings matches the trigger ID in your Autopilot dashboard.
• Ensure the trigger is active in Autopilot.
• Check that your API key has permission to access the trigger.

Contact not created or updated

If contacts aren’t being created or updated:

• Verify your API key is valid and has the correct permissions
• Check that the email field is properly formatted
• Ensure the contact data doesn’t exceed Autopilot’s field limits

FAQ

Where can I find the Autopilot API key?

1. Log in to your Autopilot dashboard.
2. Go to Settings > Autopilot API.
3. Click Generate and copy the API key.

See the Autopilot documentation for more information.

Questions? Contact us by Email or on Slack