- Introduction
-
Getting Started
- Creating an Account in Hevo
- Subscribing to Hevo via AWS Marketplace
- Subscribing to Hevo via Snowflake Marketplace
- Connection Options
- Familiarizing with the UI
- Creating your First Pipeline
- Data Loss Prevention and Recovery
- Upgrading Pipeline from Standard to Edge
-
Data Ingestion
- Types of Data Synchronization
- Ingestion Modes and Query Modes for Database Sources
- Ingestion and Loading Frequency
- Data Ingestion Statuses
- Deferred Data Ingestion
- Handling of Primary Keys
- Handling of Updates
- Handling of Deletes
- Hevo-generated Metadata
- Best Practices to Avoid Reaching Source API Rate Limits
-
Edge
- Data Ingestion
- Core Concepts
-
Pipelines
- Familiarizing with the Pipelines UI
- Creating an Edge Pipeline
- Working with Edge Pipelines
- Pipeline Job History
- Pipeline Overview
- Needs Attention
- Object and Schema Management
- Activity Log
-
Sources
- Connect AI
- PostgreSQL
- Oracle
- MySQL
- SQL Server
- Troubleshooting Database Sources
- CockroachDB
- MongoDB
- SharePoint
- Salesforce Bulk API V2
- Ordergroove
- BambooHR
- Stripe
- NetSuite SuiteAnalytics
- Shopify
- Slack
- ClickUp
- Monday.com
- Pipedrive
- Workable
- Fathom
- HubSpot
- Salesforce Marketing Cloud
- Google Analytics 4
- Google Ads
- Facebook Ads
- Microsoft Ads
- LinkedIn Ads
- Xero
- Instagram Business
- Amazon Selling Partner
- TikTok Ads
- StackAdapt
- Amazon Ads
- Pinterest Organic
- Zendesk Support
- Snapchat Ads
- TikTok Organic
- Google Search Console
- Klaviyo v2
- Braintree Payments
- Facebook Pages
- Tempo
- PayPal
- Auth0
- Pinterest Ads
- Apple Search Ads
- Permit.io
- Amplitude Analytics
- Customer.io
- Paddle
- Jira Cloud
- Fullstory
- GitHub
- WorkOS
- ActiveCampaign
- Campaign Monitor
- Infobip
- Mailgun Send
- Metaplane
- Notion
- Recharge
- sevdesk
- Statuspage
- Teamwork.com
- Workday RaaS
- Yotpo
- TikTok Shop Partner Center
- Linear
- Microsoft Dynamics 365 Business Central
- Checkout.com
- Pylon
- Increase
- Microsoft Teams
- Rollbar
- Toggl Track
- QuickBooks Online
- Zoho Desk
- Livestorm
- Attentive
- SendGrid
- Bitly
- Shortcut
- Buzzsprout
- Persona
- Mailjet
- Open Exchange Rates
- PagerDuty
- CircleCI
- SonarQube
- Chargebee
- Freshdesk
- Bing Webmaster Tools
- Rundeck
- Cal.com
- Mixpanel
- Matomo
- Walmart Marketplace
- Xray
- Reddit Ads
- Zoho Recruit
- HiBob
- Freshchat
- Zoho Books
- Marketo
- LaunchDarkly
- Outreach
- Airtable
- Attio
- Okta
- Zendesk Chat
- Bigin by Zoho CRM
- Brevo
- Naming Conventions for Source Data Entities
- Destinations
- Transformations
- Alerts
- Activate
- Custom Connectors
-
Data Loading
- Loading Data in a Database Destination
- Loading Data to a Data Warehouse
- Optimizing Data Loading for a Destination Warehouse
- Deduplicating Data in a Data Warehouse Destination
- Manually Triggering the Loading of Events
- Scheduling Data Load for a Destination
- Loading Events in Batches
- Data Loading Statuses
- Data Spike Alerts
- Name Sanitization
- Table and Column Name Compression
- Parsing Nested JSON Fields in Events
-
Pipelines
- Data Flow in a Pipeline
- Familiarizing with the Pipelines UI
- Working with Pipelines
- Managing Objects in Pipelines
- Pipeline Jobs
-
Transformations
-
Python Code-Based Transformations
- Supported Python Modules and Functions
-
Transformation Methods in the Event Class
- Create an Event
- Retrieve the Event Name
- Rename an Event
- Retrieve the Properties of an Event
- Modify the Properties for an Event
- Fetch the Primary Keys of an Event
- Modify the Primary Keys of an Event
- Fetch the Data Type of a Field
- Check if the Field is a String
- Check if the Field is a Number
- Check if the Field is Boolean
- Check if the Field is a Date
- Check if the Field is a Time Value
- Check if the Field is a Timestamp
-
TimeUtils
- Convert Date String to Required Format
- Convert Date to Required Format
- Convert Datetime String to Required Format
- Convert Epoch Time to a Date
- Convert Epoch Time to a Datetime
- Convert Epoch to Required Format
- Convert Epoch to a Time
- Get Time Difference
- Parse Date String to Date
- Parse Date String to Datetime Format
- Parse Date String to Time
- Utils
- Examples of Python Code-based Transformations
-
Drag and Drop Transformations
- Special Keywords
-
Transformation Blocks and Properties
- Add a Field
- Change Datetime Field Values
- Change Field Values
- Drop Events
- Drop Fields
- Find & Replace
- Flatten JSON
- Format Date to String
- Format Number to String
- Hash Fields
- If-Else
- Mask Fields
- Modify Text Casing
- Parse Date from String
- Parse JSON from String
- Parse Number from String
- Rename Events
- Rename Fields
- Round-off Decimal Fields
- Split Fields
- Examples of Drag and Drop Transformations
- Effect of Transformations on the Destination Table Structure
- Transformation Reference
- Transformation FAQs
-
Python Code-Based Transformations
-
Schema Mapper
- Using Schema Mapper
- Mapping Statuses
- Auto Mapping Event Types
- Manually Mapping Event Types
- Modifying Schema Mapping for Event Types
- Schema Mapper Actions
- Fixing Unmapped Fields
- Resolving Incompatible Schema Mappings
- Resizing String Columns in the Destination
- Changing the Data Type of a Destination Table Column
- Schema Mapper Compatibility Table
- Limits on the Number of Destination Columns
- File Log
- Troubleshooting Failed Events in a Pipeline
- Mismatch in Events Count in Source and Destination
- Audit Tables
- Activity Log
-
Pipeline FAQs
- Can multiple Sources connect to one Destination?
- What happens if I re-create a deleted Pipeline?
- Why is there a delay in my Pipeline?
- Can I change the Destination post-Pipeline creation?
- Why is my billable Events high with Delta Timestamp mode?
- Can I drop multiple Destination tables in a Pipeline at once?
- How does Run Now affect scheduled ingestion frequency?
- Will pausing some objects increase the ingestion speed?
- Can I see the historical load progress?
- Why is my Historical Load Progress still at 0%?
- Why is historical data not getting ingested?
- How do I set a field as a primary key?
- How do I ensure that records are loaded only once?
- Why can't I see my Pipelines after logging in?
- Events Usage
-
Sources
- Free Sources
-
Databases and File Systems
- Data Warehouses
-
Databases
- Connecting to a Local Database
- Amazon DocumentDB
- Amazon DynamoDB
- Elasticsearch
-
MongoDB
- Generic MongoDB
- MongoDB Atlas
- Support for Multiple Data Types for the _id Field
- Example - Merge Collections Feature
-
Troubleshooting MongoDB
-
Errors During Pipeline Creation
- Error 1001 - Incorrect credentials
- Error 1005 - Connection timeout
- Error 1006 - Invalid database hostname
- Error 1007 - SSH connection failed
- Error 1008 - Database unreachable
- Error 1011 - Insufficient access
- Error 1028 - Primary/Master host needed for OpLog
- Error 1029 - Version not supported for Change Streams
- SSL 1009 - SSL Connection Failure
- Troubleshooting MongoDB Change Streams Connection
- Troubleshooting MongoDB OpLog Connection
-
Errors During Pipeline Creation
- SQL Server
-
MySQL
- Amazon Aurora MySQL
- Amazon RDS MySQL
- Azure MySQL
- Generic MySQL
- Google Cloud MySQL
- MariaDB MySQL
-
Troubleshooting MySQL
-
Errors During Pipeline Creation
- Error 1003 - Connection to host failed
- Error 1006 - Connection to host failed
- Error 1007 - SSH connection failed
- Error 1011 - Access denied
- Error 1012 - Replication access denied
- Error 1017 - Connection to host failed
- Error 1026 - Failed to connect to database
- Error 1027 - Unsupported BinLog format
- Failed to determine binlog filename/position
- Schema 'xyz' is not tracked via bin logs
- Errors Post-Pipeline Creation
-
Errors During Pipeline Creation
- MySQL FAQs
- Oracle
-
PostgreSQL
- Amazon Aurora PostgreSQL
- Amazon RDS PostgreSQL
- Azure PostgreSQL
- Generic PostgreSQL
- Google Cloud PostgreSQL
- Heroku PostgreSQL
- Upgrading Pipelines with PostgreSQL Sources to Use the pgoutput Plugin
-
Troubleshooting PostgreSQL
-
Errors during Pipeline creation
- Error 1003 - Authentication failure
- Error 1006 - Connection settings errors
- Error 1011 - Access role issue for logical replication
- Error 1012 - Access role issue for logical replication
- Error 1014 - Database does not exist
- Error 1017 - Connection settings errors
- Error 1023 - No pg_hba.conf entry
- Error 1024 - Number of requested standby connections
- Errors Post-Pipeline Creation
-
Errors during Pipeline creation
-
PostgreSQL FAQs
- Can I track updates to existing records in PostgreSQL?
- How can I migrate a Pipeline created with one PostgreSQL Source variant to another variant?
- How can I prevent data loss when migrating or upgrading my PostgreSQL database?
- Why do FLOAT4 and FLOAT8 values in PostgreSQL show additional decimal places when loaded to BigQuery?
- Why is data not being ingested from PostgreSQL Source objects?
- Troubleshooting Database Sources
- Database Source FAQs
- File Storage
- Engineering Analytics
- Finance & Accounting Analytics
-
Marketing Analytics
- ActiveCampaign
- AdRoll
- Amazon Ads
- Apple Search Ads
- AppsFlyer
- CleverTap
- Criteo
- Drip
- Facebook Ads
- Facebook Page Insights
- Firebase Analytics
- Freshsales
- Google Ads
- Google Analytics 4
- Google Analytics 360
- Google Play Console
- Google Search Console
- HubSpot
- Instagram Business
- Klaviyo v2
- Lemlist
- LinkedIn Ads
- Mailchimp
- Mailshake
- Marketo
- Microsoft Ads
- Onfleet
- Outbrain
- Pardot
- Pinterest Ads
- Pipedrive
- Recharge
- Segment
- SendGrid Webhook
- SendGrid
- Salesforce Marketing Cloud
- Snapchat Ads
- SurveyMonkey
- Taboola
- TikTok Ads
- Twitter Ads
- Typeform
- YouTube Analytics
- Product Analytics
- Sales & Support Analytics
- Source FAQs
-
Destinations
- Familiarizing with the Destinations UI
- Cloud Storage-Based
- Databases
-
Data Warehouses
- Amazon Redshift
- Amazon Redshift Serverless
- Azure Synapse Analytics
- Databricks
-
Google BigQuery
- Clustering in BigQuery
- Partitioning in BigQuery
- Structure of Data in the Google BigQuery Data Warehouse
- Loading Data to a Google BigQuery Data Warehouse
- Near Real-time Data Loading using Streaming
- Modifying BigQuery Destinations to Use Service Account Authentication
- Troubleshooting Google BigQuery
- Google BigQuery FAQs
- Hevo Managed Google BigQuery
- Snowflake
- Troubleshooting Data Warehouse Destinations
-
Destination FAQs
- Can I change the primary key in my Destination table?
- Can I change the Destination table name after creating the Pipeline?
- How can I change or delete the Destination table prefix?
- Why does my Destination have deleted Source records?
- How do I filter deleted Events from the Destination?
- Does a data load regenerate deleted Hevo metadata columns?
- How do I filter out specific fields before loading data?
- Transform
- Alerts
- Account Management
- Activate
- Glossary
-
Releases-
2026 Releases
- Release 2.53 (August 24 – September 21, 2026)
- Release 2.52 (July 27 – August 24, 2026)
- Release 2.51 (Jun 29 – July 27 , 2026)
- Release 2.50 (Jun 01–29, 2026)
- Release 2.49 (May 04-Jun 01, 2026)
- Release 2.48 (Apr 06-May 04, 2026)
- Release 2.47 (Mar 09-Apr 06, 2026)
- Release 2.46 (Feb 09-Mar 09, 2026)
- Release 2.45 (Jan 12-Feb 09, 2026)
-
2025 Releases
- Release 2.44 (Dec 01, 2025-Jan 12, 2026)
- Release 2.43 (Nov 03-Dec 01, 2025)
- Release 2.42 (Oct 06-Nov 03, 2025)
- Release 2.41 (Sep 08-Oct 06, 2025)
- Release 2.40 (Aug 11-Sep 08, 2025)
- Release 2.39 (Jul 07-Aug 11, 2025)
- Release 2.38 (Jun 09-Jul 07, 2025)
- Release 2.37 (May 12-Jun 09, 2025)
- Release 2.36 (Apr 14-May 12, 2025)
- Release 2.35 (Mar 17-Apr 14, 2025)
- Release 2.34 (Feb 17-Mar 17, 2025)
- Release 2.33 (Jan 20-Feb 17, 2025)
-
2024 Releases
- Release 2.32 (Dec 16 2024-Jan 20, 2025)
- Release 2.31 (Nov 18-Dec 16, 2024)
- Release 2.30 (Oct 21-Nov 18, 2024)
- Release 2.29 (Sep 30-Oct 22, 2024)
- Release 2.28 (Sep 02-30, 2024)
- Release 2.27 (Aug 05-Sep 02, 2024)
- Release 2.26 (Jul 08-Aug 05, 2024)
- Release 2.25 (Jun 10-Jul 08, 2024)
- Release 2.24 (May 06-Jun 10, 2024)
- Release 2.23 (Apr 08-May 06, 2024)
- Release 2.22 (Mar 11-Apr 08, 2024)
- Release 2.21 (Feb 12-Mar 11, 2024)
- Release 2.20 (Jan 15-Feb 12, 2024)
-
2023 Releases
- Release 2.19 (Dec 04, 2023-Jan 15, 2024)
- Release Version 2.18
- Release Version 2.17
- Release Version 2.16 (with breaking changes)
- Release Version 2.15 (with breaking changes)
- Release Version 2.14
- Release Version 2.13
- Release Version 2.12
- Release Version 2.11
- Release Version 2.10
- Release Version 2.09
- Release Version 2.08
- Release Version 2.07
- Release Version 2.06
-
2022 Releases
- Release Version 2.05
- Release Version 2.04
- Release Version 2.03
- Release Version 2.02
- Release Version 2.01
- Release Version 2.00
- Release Version 1.99
- Release Version 1.98
- Release Version 1.97
- Release Version 1.96
- Release Version 1.95
- Release Version 1.93 & 1.94
- Release Version 1.92
- Release Version 1.91
- Release Version 1.90
- Release Version 1.89
- Release Version 1.88
- Release Version 1.87
- Release Version 1.86
- Release Version 1.84 & 1.85
- Release Version 1.83
- Release Version 1.82
- Release Version 1.81
- Release Version 1.80 (Jan-24-2022)
- Release Version 1.79 (Jan-03-2022)
-
2021 Releases
- Release Version 1.78 (Dec-20-2021)
- Release Version 1.77 (Dec-06-2021)
- Release Version 1.76 (Nov-22-2021)
- Release Version 1.75 (Nov-09-2021)
- Release Version 1.74 (Oct-25-2021)
- Release Version 1.73 (Oct-04-2021)
- Release Version 1.72 (Sep-20-2021)
- Release Version 1.71 (Sep-09-2021)
- Release Version 1.70 (Aug-23-2021)
- Release Version 1.69 (Aug-09-2021)
- Release Version 1.68 (Jul-26-2021)
- Release Version 1.67 (Jul-12-2021)
- Release Version 1.66 (Jun-28-2021)
- Release Version 1.65 (Jun-14-2021)
- Release Version 1.64 (Jun-01-2021)
- Release Version 1.63 (May-19-2021)
- Release Version 1.62 (May-05-2021)
- Release Version 1.61 (Apr-20-2021)
- Release Version 1.60 (Apr-06-2021)
- Release Version 1.59 (Mar-23-2021)
- Release Version 1.58 (Mar-09-2021)
- Release Version 1.57 (Feb-22-2021)
- Release Version 1.56 (Feb-09-2021)
- Release Version 1.55 (Jan-25-2021)
- Release Version 1.54 (Jan-12-2021)
-
2020 Releases
- Release Version 1.53 (Dec-22-2020)
- Release Version 1.52 (Dec-03-2020)
- Release Version 1.51 (Nov-10-2020)
- Release Version 1.50 (Oct-19-2020)
- Release Version 1.49 (Sep-28-2020)
- Release Version 1.48 (Sep-01-2020)
- Release Version 1.47 (Aug-06-2020)
- Release Version 1.46 (Jul-21-2020)
- Release Version 1.45 (Jul-02-2020)
- Release Version 1.44 (Jun-11-2020)
- Release Version 1.43 (May-15-2020)
- Release Version 1.42 (Apr-30-2020)
- Release Version 1.41 (Apr-2020)
- Release Version 1.40 (Mar-2020)
- Release Version 1.39 (Feb-2020)
- Release Version 1.38 (Jan-2020)
-
2026 Releases
- Early Access New
Amazon Selling Partner (Edge)
Amazon Selling Partner (Seller Central) is Amazon’s platform for third-party sellers to list, price, fulfill, and manage products sold across Amazon’s marketplaces worldwide. It gives sellers tools to manage orders, inventory, advertising, financial settlements, and customer service, enabling businesses to scale their e-commerce operations while maintaining visibility into sales performance and fulfillment.
Hevo uses the Amazon Selling Partner API (SP-API) to replicate data from your Amazon Selling Partner account to the Destination of your choice.
Hevo supports the following authentication methods to connect to your Amazon Selling Partner account:
-
Open Authorization (OAuth): Allows Hevo to connect to your account through an authorization flow, where you sign in to Amazon and grant Hevo access to your account data.
-
OAuth app: Allows Hevo to connect to your account using the client ID, client secret, and refresh token of an OAuth app that you create in Amazon.
Note: To create a Pipeline with Amazon Selling Partner as the Source using an OAuth app, you must use the Create a Pipeline endpoint through the Hevo API. This method is not available in the Hevo UI. Read Creating a Pipeline with Hevo API for the steps to create the Pipeline.
Supported Features
| Feature Name | Supported |
|---|---|
| Capture deletes | Yes |
| History mode | No |
| Custom data (user-configured tables & fields) | No |
| Priority-First Sync | Yes |
| Data blocking (skip objects and fields) | Yes |
| Resync (objects and Pipelines) | Yes |
| API configurable | Yes |
Prerequisites
-
An active Amazon Selling Partner (Seller Central) account exists from which data is to be ingested.
-
You must have administrative access to authorize third-party applications in Seller Central.
Configure Amazon Selling Partner as a Source in your Pipeline
Perform the following steps to configure your Amazon Selling Partner Source:
-
Click Pipelines in the Navigation Bar.
-
Click + Create Pipeline in the Pipelines List View.
-
On the Select Source Type page, select Amazon Selling Partner.
-
On the Select Destination Type page, select the type of Destination you want to use.
-
In the Configure Source screen, specify the following:

-
Source Name: A unique name for your Source, not exceeding 255 characters. For example, Amazon Selling Partner Source.
-
In the Connect to your Amazon Selling Partner account section, do the following:
-
From the Region drop-down, select the Amazon Selling Partner region for your seller account. This determines the Amazon Seller host and API endpoint Hevo uses to connect to your account. Default value: North America.
-
Click Authenticate Your Amazon Selling Partner Account, sign in, and grant Hevo access to your account.
-
-
In the Historical Sync Window section, from the Historical Sync Duration drop-down, select the duration for which you want to ingest existing data from the Source. This cannot be changed after the Pipeline is created. Default value: 2 Years.
Note: Amazon Selling Partners has low API rate limits, which can slow syncing large amounts of historical data. To speed up the initial sync, consider choosing a duration of 1 year or less.
-
-
Click Test & Continue to test the connection to your Amazon Selling Partner Source.
Configure Amazon Selling Partner as a Source Using the Hevo API
You can connect Hevo to your Amazon Selling Partner account with an OAuth app created in the Solution Provider Portal. This method is available only through the Hevo API. Specify the credentials of the app in the request that creates the Pipeline, and Hevo uses them to authenticate with your account.
The following credentials from your OAuth app are required to authenticate the connection:
-
Client ID: The unique identifier of your app. Amazon displays it with the client secret when you view the app’s Login with Amazon (LWA) credentials. Read View your Application Information and Credentials for the steps to find it.
-
Client Secret: The private key of your app. Hevo sends it with the client ID to authenticate the request.
-
Refresh Token: A long-lived token that your app receives the first time an Amazon user authorizes it. Hevo exchanges this token for a short-lived access token when the Pipeline is created, and refreshes that token automatically, so the connection keeps working without anyone signing in again.
-
(Optional) Application ID: The identifier that Amazon assigns to your app, in the format amzn1.sellerapps.app.<id>. Amazon uses it in the authorization Uniform Resource Identifier (URI) to identify the app that the selling partner is authorizing. Hevo does not need it to authenticate through the API, because the token is refreshed with the client ID, the client secret and the refresh token only. If you send it, send it as
auth.client_access.application_id.
Create the app in the Solution Provider Portal. Read Register your Application for the steps to create the app, and Website Authorization Workflow for the steps to build its authorization URI and exchange the authorization code for a refresh token.
Prepare the Source Configuration
Before you build your request, retrieve the settings that the Amazon Selling Partner connector currently accepts. Refer to Read the Connector Configuration for the steps to retrieve them, and Using your own OAuth app for the keys that this method accepts.
In the response, the auth object describes the credentials of your own OAuth app. In the connector configuration response, Hevo returns the auth object under data.schema.properties.auth, and the connector settings under data.schema.properties.config. Only a connector that accepts an OAuth app has an auth property. Each credential carries "type": "string". Every credential except client_id also carries "format": "password" and "writeOnly": true. The following example shows part of the auth object:
{
"auth": {
"required": [
"client_access"
],
"properties": {
"client_access": {
"required": [
"client_id",
"client_secret"
],
"properties": {
"client_id": {
"title": "Client ID"
},
"client_secret": {
"title": "Client Secret"
},
"application_id": {
"title": "application_id"
}
}
},
"refresh_token": {
"title": "Refresh Token"
},
"access_token": {
"title": "Access Token"
}
},
"anyOf": [
{
"required": [
"refresh_token"
]
},
{
"required": [
"access_token"
]
}
]
}
}
The config.subdomain value selects the Amazon SP-API endpoint for the region of your seller account. Specify one of the following values:
-
NA for North America
-
EU for Europe
-
FE for the Far East
The connector configuration shows a default for this value, but it is required when you authenticate with your own OAuth app. A request without it fails. You cannot change the value after the Pipeline is created.
A Source that you create with your own OAuth app does not capture the selling partner ID, because Amazon returns that ID only when you authorize through a browser. As a result, such a Source has the following limitations:
-
Hevo does not replicate the Listed Item object, which holds your seller-specific details for each SKU, or any of its child objects.
-
The
selling_partner_idfield of the Marketplace Participation object is empty.
Authorize the Source in the Hevo UI if you need this data.
Specify the credentials of your app in the auth object. The following example shows the source object for an Amazon Selling Partner Source:
{
"name": "<source_name>",
"connector_id": "amazon_selling_partner",
"type": "AMAZON_SELLING_PARTNER",
"config": {
"subdomain": "NA",
"historical_sync_duration": "LAST_2_YEARS"
},
"auth": {
"client_access": {
"client_id": "<client_id>",
"client_secret": "<client_secret>",
"application_id": "<application_id>"
},
"refresh_token": "<refresh_token>"
}
}
Note: Replace the placeholder values in the example with your own. For example, <source_name> with My Amazon Selling Partner Account.
Specify this source object in the request that creates your Pipeline. Read Creating a Pipeline with Hevo API for the complete request and the remaining steps.
Hevo validates the credentials and tests the Source and Destination connections before it saves anything. To test the Source connection, Hevo uses the credentials in the auth object to generate an access token. If a credential is rejected or a test fails, the request returns an error, and no Pipeline is created. Hevo also deletes the access token that it generated.
Note: Hevo does not store these credentials in the Source configuration. It exchanges them for a token when the Pipeline is created and refreshes that token from then on. Hevo does not return them if you retrieve the Source configuration later. If you revoke the credentials in Amazon, Hevo cannot authenticate with the Source. As a result, all active jobs for the Pipeline fail, and no data is replicated. To resume data replication, send the new credentials using the Modify Source Configuration in a Pipeline endpoint. Read Modifying the Source Configuration for the steps to send them.
Data Replication
Hevo replicates data for all the objects selected on the Configure Objects page during Pipeline creation. By default, all supported objects and their available fields are selected. However, you can modify this selection while creating or editing the Pipeline.
Hevo ingests the following types of data from your Source objects:
-
Historical Data: The first run of the Pipeline ingests historical data for the selected objects based on the Historical Sync Duration specified when configuring the Source, and loads it into the Destination. Hevo uses priority-first sync to first load the data created in the last 7 days for a defined set of objects, and then loads the older data, starting in the same run and continuing in the next runs if needed.
-
Incremental Data: Once the historical load is complete, new and updated records for objects are ingested as per the sync frequency.
For the following objects, Hevo ingests only the incremental data in subsequent Pipeline runs:
| Object Category | Objects |
|---|---|
| Orders | Orders, Order Item, Order Item Promotion ID, Order Item Serial Number, Order Regulated Info, Regulated Information Field, Marketplace Tax Classification, Payment Method Detail Item, Approval Support Data Element, Cash On Delivery (COD) Payment Execution Detail |
| Financial Events | Financial Event Group, Financial Shipment Event, Financial Shipment Event Item, Financial Shipment Event Item Promotion, Financial Shipment Direct Payment, Financial Fee Component, Financial Charge Component, Financial Adjustment Item, Financial Service Fee Event, Financial Product Ads Payment Event, Financial Retro Charge Event, Financial Coupon Payment Event, Financial Seller Assurance For E-commerce Transactions (SAFE-T) Reimbursement Event, Financial SAFE-T Reimbursement Item, Financial Removal Shipment Event, Financial Removal Shipment Item, Financial Removal Shipment Adjustment Event, Financial Removal Shipment Item Adjustment, Financial Pay With Amazon Event, Financial Solution Provider Credit Event, Financial Rental Transaction Event, Financial Loan Servicing Event, Financial Fulfillment by Amazon (FBA) Liquidation Event, Financial Seller Review Enrollment Payment Event, Financial Imaging Services Fee Event, Financial Seller Deal Payment Event, Financial Affordability Expense Event, Network Commingling Transaction Event, Financial Debt Recovery Event, Financial Debt Recovery Item, Financial Charge Instrument, Financial Adhoc Disbursement Event, Financial Failed Adhoc Disbursement Event, Financial Capacity Reservation Billing Event, Financial Value Added Service Charge Event, Financial Charge Refund Event, Financial Tax Deduction at Source (TDS) Reimbursement Event, Financial Tax Withholding Event, Financial Trial Shipment Event |
| FBA Inventory and Fulfillment | FBA Inventory Summary, FBA Inventory Researching Quantity Entry, Fulfillment Order |
| Reports | Orders Report |
For all other objects, Hevo ingests the entire data during each Pipeline run.
Amazon SP-API enforces per-operation usage plans and rate limits that vary by SP-API operation and Amazon store, and that can adjust dynamically based on your account’s business metrics. If this limit is exceeded, a rate limit exception occurs. To understand how Hevo handles such scenarios, read Handling Rate Limit Exceptions.
Note: You can create a Pipeline with this Source only using the Merge load mode. The Append mode is not supported for this Source.
Schema and Primary Keys
Hevo uses the following schema to upload the records to the Destination. For a detailed view of the objects, fields, and relationships, click the ERD.
Data Model
The following is the list of tables (objects) that are created at the Destination when you run the Pipeline:
| Object | Description |
|---|---|
| Catalog | Contains the top-level identifier for an item listed on Amazon, known as the Amazon Standard Identification Number (ASIN), scoped to a marketplace. It includes the following child objects: - Item Classification Sales Rank - Item Dimension - Item Display Group Sales Rank - Item Identifier - Item Image - Item Product Type - Item Relationship - Item Summary - Item Variation Theme |
| Competitive Price Type | Contains pricing details that Amazon uses to compare an item’s price against prices offered by other sellers. It includes the following child objects: - Competitive Price Type (CPT) Trade-In Value - Item Buy Box Price Type - Item Offer Count Type - Item Offer Detail - Item Offer Lowest Price Type - Item Offer Summary - Item Quantity Discount Price Type - Item Sales Rank Type |
| Content Meta Data Record | Contains details of an enhanced product content page (Amazon’s A+ Content), such as its name, status, and the time it was last updated. It includes a child object, Content Badge Set. |
| Customer Shipment Sales Report | Contains item-level sales details for customer shipments fulfilled by Amazon, such as item price, tax, and shipping or gift-wrap charges. |
| Easyship Package | Contains details of the orders scheduled for pickup through Amazon’s Easy Ship program, such as the package status, tracking ID, and invoice details. It includes the following child objects: - Easyship Package Item - Easyship Package Item Serial Number |
| FBA Returns Report | Contains details of customer returns for orders fulfilled by Amazon, such as the return date, reason, outcome, and any customer comments. |
| Fee Preview Report | Contains estimated fulfillment fees per SKU, such as the referral fee, pick-and-pack fee, and weight handling fee. |
| Feed | Contains the submissions made to Amazon for processing, such as submission type, processing status, and processing start and end times. |
| Financial Event Group | Contains financial transactions grouped by payout cycle, including payments, fees, adjustments, and refunds. It includes the following child objects: - Financial Adhoc Disbursement Event - Financial Adjustment Item - Financial Affordability Expense Event - Financial Capacity Reservation Billing Event - Financial Charge Component - Financial Charge Instrument - Financial Charge Refund Event - Financial Coupon Payment Event - Financial Debt Recovery Event - Financial Debt Recovery Item - Financial Failed Adhoc Disbursement Event - Financial FBA Liquidation Event - Financial Fee Component - Financial Imaging Services Fee Event - Financial Loan Servicing Event - Financial Pay With Amazon Event - Financial Product Ads Payment Event - Financial Removal Shipment Adjustment Event - Financial Removal Shipment Event - Financial Removal Shipment Item - Financial Removal Shipment Item Adjustment - Financial Rental Transaction Event - Financial Retro Charge Event - Financial SAFE-T Reimbursement Event - Financial SAFE-T Reimbursement Item - Financial Seller Deal Payment Event - Financial Seller Review Enrollment Payment Event - Financial Service Fee Event - Financial Shipment Direct Payment - Financial Shipment Event - Financial Shipment Event Item - Financial Shipment Event Item Promotion - Financial Solution Provider Credit Event - Financial Tax Withholding Event - Financial TDS Reimbursement Event - Financial Trial Shipment Event - Financial Value Added Service Charge Event - Network Commingling Transaction Event |
| Fulfilled Shipments Data General Report | Contains detailed information for shipments completed through Amazon’s fulfillment service, such as item price, tax, shipping details, and carrier. |
| Fulfillment by Amazon (FBA) Inventory Summary | Contains stock details for each Stock Keeping Unit (SKU) held in Amazon’s fulfillment centers, including available, incoming, reserved, and unavailable quantities. It includes a child object, FBA Inventory Researching Quantity Entry. |
| Fulfillment Customer Shipment Promotion Report | Contains details of promotions applied to customer shipments fulfilled by Amazon. |
| Fulfillment Order | Contains details of orders fulfilled by Amazon, such as status, shipping speed, delivery window, and cash-on-delivery charge amounts. It includes the following child objects: - Fullfillment Order Feature Settings - Fullfillment Order Notification Email |
| Fulfillment Removal Order Detail Report | Contains details of requests to remove inventory from Amazon’s fulfillment centers, such as the outcome, quantity requested and shipped, and any fees charged. |
| Listed Item | Contains your seller-specific details for a SKU, such as procurement cost. It includes the following child objects: - Item Fulfillment Availability - Listed Item Issue - Listed Item Offers - Listed Item Summary - Return Reason Code |
| Long Term Storage Fee Charges Report | Contains the additional charges for inventory stored in Amazon’s fulfillment centers beyond a certain period, per SKU, such as the age tier of the surcharge and the amount charged. |
| Market Basket Analysis Report Daily | Contains daily data on items frequently purchased together with a given product, along with the frequency of the combination. |
| Market Basket Analysis Report Monthly | Contains monthly data on items frequently purchased together with a given product, along with the frequency of the combination. |
| Market Basket Analysis Report Quarterly | Contains quarterly data on items frequently purchased together with a given product, along with the frequency of the combination. |
| Marketplace Participation | Contains the sales regions your account operates in, including the region name, country code, default currency, and default language. |
| Orders | Contains details about purchases made on Amazon, including status, purchase date, fulfillment method, and shipping information. It includes the following child objects: - Approval Support Data Element - COD Payment Execution Detail - Marketplace Tax Classification - Order Item - Order Item Promotion ID - Order Item Serial Number - Order Regulated Info - Payment Method Detail Item - Regulated Information Field |
| Orders Report | Contains a summary of order and item-level details, such as order status, SKU, item price, shipping address, and promotion codes, generated from Amazon’s report of all orders since their last update. |
| Outbound Seller Feature | Contains the fulfillment programs and related capabilities that your seller account is eligible for in a marketplace. It includes a child object, Inventory Feature. |
| Package Tracking Detail | Contains shipment tracking information for a package fulfilled by Amazon, such as the carrier, tracking number, and current delivery status. It includes a child object, Package Tracking Event. |
| Reimbursements Report | Contains details of payments issued to sellers to compensate for lost or damaged inventory, such as the reason, amount, and quantity involved. |
| Repeat Purchase Report Monthly | Contains monthly data on customer repeat purchases for a product, such as unique customers, the percentage who purchased again, and revenue from repeat purchases. |
| Repeat Purchase Report Quarterly | Contains quarterly data on customer repeat purchases for a product, such as unique customers, the percentage who purchased again, and revenue from repeat purchases. |
| Repeat Purchase Report Weekly | Contains weekly data on customer repeat purchases for a product, such as unique customers, the percentage who purchased again, and revenue from repeat purchases. |
| Sales And Traffic Business Child ASIN Report Daily | Contains daily performance metrics broken down by child ASIN. |
| Sales And Traffic Business Child ASIN Report Monthly | Contains monthly performance metrics broken down by child ASIN. |
| Sales And Traffic Business Parent ASIN Report Daily | Contains daily performance metrics broken down by parent ASIN. |
| Sales And Traffic Business Parent ASIN Report Monthly | Contains monthly performance metrics broken down by parent ASIN. |
| Sales And Traffic Business Report Daily | Contains daily performance metrics for your account, such as product sales, units ordered, sessions, and Buy Box percentage. |
| Sales And Traffic Business Report Monthly | Contains monthly performance metrics for your account, such as product sales, units ordered, sessions, and Buy Box percentage. |
| Sales And Traffic Business SKU Report Daily | Contains daily performance metrics broken down by SKU. |
| Sales And Traffic Business SKU Report Monthly | Contains monthly performance metrics broken down by SKU. |
| Search Terms Report Daily | Contains daily data on the terms customers search for on Amazon, such as search frequency rank, click share, and conversion share for each term. |
| Search Terms Report Monthly | Contains monthly data on the terms customers search for on Amazon, such as search frequency rank, click share, and conversion share for each term. |
| Search Terms Report Quarterly | Contains quarterly data on the terms customers search for on Amazon, such as search frequency rank, click share, and conversion share for each term. |
| Search Terms Report Weekly | Contains weekly data on the terms customers search for on Amazon, such as search frequency rank, click share, and conversion share for each term. |
| Seller Fulfilled Returns Report | Contains details of customer returns for the orders that you fulfill yourself, such as the return request date, reason, resolution, return label cost, and SAFE-T claim details. |
| Settlement Report | Contains details of payment transactions processed for your account, such as the period covered, deposit date, transaction type, and amount. |
| Storage Fee Charges Report | Contains the monthly charges for storing inventory in Amazon’s fulfillment centers per SKU, such as the average quantity on hand and the estimated fee for that month. |
Additional Information
Read the detailed Hevo documentation for the following related topics:
Handling of Deletes
Hevo uses a full data refresh approach to capture delete actions for the following objects. During each Pipeline run, Hevo compares the data fetched from the Source object with the data present in the Destination table. If a record exists in the Destination but is no longer returned by the Source, the record is marked as deleted by setting the value of the metadata column __hevo__marked_deleted to True:
-
Catalog
-
Item Summary
-
Item Identifier
-
Item Image
-
Item Product Type
-
Item Relationship
-
Item Sales Rank Type
-
Item Classification Sales Rank
-
Item Display Group Sales Rank
-
Item Variation Theme
-
Item Dimension
-
Item Offer Summary
-
Item Offer Detail
-
Item Offer Count Type
-
Item Offer Lowest Price Type
-
Item Buy Box Price Type
-
Item Quantity Discount Price Type
-
Competitive Price Type
-
CPT Trade-In Value
For all other objects, Hevo does not capture deletes.
Source Considerations
-
Amazon limits how far back Hevo can retrieve data for some objects, regardless of the Historical Sync Duration you select. For example, Settlement Report data is available for up to 90 days, while Orders and Financial Events data is available for up to 2 years.
-
Some objects require Amazon to grant a specific report role to your seller account before Hevo can access them. This applies to Brand Analytics reports, such as Search Terms, Market Basket Analysis, and Repeat Purchase, as well as some FBA reports. These objects are available only after Amazon approves the required report role for your account.
Limitations
-
Some Amazon SP-API objects require specific roles to access them. Hevo does not support the Professional Services (Restricted) and Direct-to-Consumer Shipping (Restricted) roles. As a result, the following objects are unavailable for selection when creating a Pipeline and are marked as Inaccessible on the Objects page:
-
Easy Ship Package
-
Easy Ship Package Item
-
Easy Ship Package Item Serial Number
-
Service Job
-
Service Job Appointment
-
Service Job Appointment Time
-
Technician
-
Revision History
Refer to the following table for the list of key updates made to this page:
| Date | Release | Description of Change |
|---|---|---|
| Oct-30-2026 | 2.54 | Updated sections: - Supported Features and Data Replication to add information about priority-first sync. - Data Model to add the Easyship Package and Seller Fulfilled Returns Report objects. |
| Oct-19-2026 | 2.54 | Added section, Configure Amazon Selling Partner as a Source Using the Hevo API. |
| Aug-18-2026 | NA | New document. |