Supported syncing
For more information about sync modes, refer to the sync modes docs.
Connect to Maxio
Go to the Destinations overview page and click the Add destination button. Select Maxio and click Continue. You can then authenticate Hightouch to Maxio by entering the following required fields into Hightouch:- Subdomain: Part of your URL, for example,
example-subdomaininhttps://example-subdomain.chargify.com - API key: A valid Maxio API key, follow Maxio’s instructions to view or create a new API key
- Password: The same one you used to log into your account
Sync configuration
Once you’ve set up your Maxio destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Maxio destination you want to sync to.Syncing customers
When syncing customers, you can choose from upsert, update, or insert modes.Record matching
To match rows from your model to customers in Maxio, you need to select a model column and corresponding Maxio field. You can match on any of the following Maxio fields:- id
- reference
In Insert mode, Maxio automatically generates an identifier for every new record synced, so there is no need to match an existing record.
Field mapping
You can map data from any of your model columns to fields in Maxio. Maxio requires the following fields, so you must map them to complete your configuration:- first_name
- last_name
Delete behavior
The delete behavior you select dictates what to do when a row no longer appears in your model’s query results. You have the following options:Syncing subscriptions
When syncing subscriptions, you can choose from upsert, update, or insert modes.Record matching
To match rows from your model to records in Maxio, you need to select the model column that contains values that match the reference field.In Insert mode, Maxio automatically generates an identifier for every new record synced, so there is no need to match an existing record.
Field mapping
You can map data from any of your model columns to fields in Maxio. Maxio requires the following fields, so you must map them to complete your configuration:- customer_attributes, customer_id or customer_reference
- payment_profile_id
- product_handle or product_id
Syncing usage data
Hightouch lets you report usage events to Maxio. To do so, you must select the Maxio subscription and component you would like to sync to.Record matching
Maxio automatically generates an identifier for every new record synced, so there is no need to match an existing record.Field mapping
You can sync columns from your model to Maxio default usage fields. Check out Maxio’s usage docs to learn more.Syncing events
Maxio requires the following event parameters:api-handle: You can either provide a static value or select to use a column from your model.subdomain: Hightouch uses the subdomain you entered when connecting to Maxio
Event timestamp
You can optionally select a column that contains timestamps of when events occurred. If this field is empty, Hightouch uses the time the event arrives at the server. Hightouch syncs the timestamp as theevent_time parameter the Maxio requires.