Skip to content
Book a demoStart free
Connectors

eBay Fulfillment connector

Set up the eBay Fulfillment connector in Kaivo: authentication, configuration, the 1 BigQuery tables it syncs, and answers to common questions.

eBay Fulfillment connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your eBay Fulfillment data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your e-commerce data instead of moving it.

Sync your eBay Fulfillment data into BigQuery with Kaivo to analyse orders and fulfilment performance.

CategoryE-commerce
AuthenticationAPI key
SetupSelf-service

Getting started with the eBay Fulfillment connector

Section titled “Getting started with the eBay Fulfillment connector”
  1. Sign up for Kaivo and create a workspace.
  2. Connect your eBay Fulfillment account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your eBay Fulfillment credentials. You provide:

Field Description
Client Secret
Your eBay developer application Client Secret.

| | Refresh Token |

The OAuth refresh token obtained after authorizing your eBay developer application.

|

Prerequisites

This connector authenticates using your own eBay developer application:

  1. Create an application in the eBay Developer Program portal, note its Client ID and Client Secret, and register a Redirect URI.
  2. Complete the OAuth authorization flow to obtain a Refresh Token (see eBay’s OAuth documentation).

Then enter those values below.

Need help? Reach our team via the chat in the bottom-right corner.

Configuring the eBay Fulfillment connector

Section titled “Configuring the eBay Fulfillment connector”

When you set up the connector, you provide:

Field Description
Client ID
Your eBay developer application Client ID.

| | Redirect URI |

The Redirect URI (RuName) configured in your eBay developer application. It must match exactly.

| | Start Date |

Any data before this date will not be fetched.

|

Tables and columns synced from eBay Fulfillment

Section titled “Tables and columns synced from eBay Fulfillment”

Kaivo syncs 1 table from eBay Fulfillment into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

orders (46 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
buyer__buyer_registration_address__contact_address__address_line1 STRING
buyer__buyer_registration_address__contact_address__address_line2 STRING
buyer__buyer_registration_address__contact_address__city STRING
buyer__buyer_registration_address__contact_address__country_code STRING
buyer__buyer_registration_address__contact_address__postal_code STRING
buyer__buyer_registration_address__contact_address__state_or_province STRING
buyer__buyer_registration_address__email STRING
buyer__buyer_registration_address__full_name STRING
buyer__buyer_registration_address__primary_phone__phone_number STRING
buyer__buyer_registration_address__secondary_phone__phone_number STRING
buyer__tax_address__city STRING
buyer__tax_address__country_code STRING
buyer__tax_address__postal_code STRING
buyer__tax_address__state_or_province STRING
buyer__username STRING
buyer_checkout_notes STRING
cancel_status__cancel_state STRING
creation_date STRING
ebay_collect_and_remit_tax BOOL
last_modified_date STRING
legacy_order_id STRING
order_fulfillment_status STRING
order_id STRING
order_payment_status STRING
payment_summary__total_due_seller__currency STRING
payment_summary__total_due_seller__value STRING
pricing_summary__delivery_cost__currency STRING
pricing_summary__delivery_cost__value STRING
pricing_summary__delivery_discount__currency STRING
pricing_summary__delivery_discount__value STRING
pricing_summary__price_discount__currency STRING
pricing_summary__price_discount__value STRING
pricing_summary__price_subtotal__currency STRING
pricing_summary__price_subtotal__value STRING
pricing_summary__total__currency STRING
pricing_summary__total__value STRING
program__authenticity_verification__status STRING
program__ebay_shipping__shipping_label_provided_by STRING
sales_record_reference STRING
seller_id STRING
total_fee_basis_amount__currency STRING
total_fee_basis_amount__value STRING
total_marketplace_fee__currency STRING
total_marketplace_fee__value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__cancel_status__cancel_requests

Section titled “Subtable: orders__cancel_status__cancel_requests”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
cancel_initiator STRING
cancel_reason STRING
cancel_request_id STRING
cancel_request_state STRING
cancel_requested_date STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__fulfillment_start_instructions

Section titled “Subtable: orders__fulfillment_start_instructions”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
ebay_supported_fulfillment BOOL
final_destination_address__address_line1 STRING
final_destination_address__address_line2 STRING
final_destination_address__city STRING
final_destination_address__country_code STRING
final_destination_address__postal_code STRING
final_destination_address__state_or_province STRING
fulfillment_instructions_type STRING
max_estimated_delivery_date STRING
min_estimated_delivery_date STRING
shipping_step__ship_to__contact_address__address_line1 STRING
shipping_step__ship_to__contact_address__address_line2 STRING
shipping_step__ship_to__contact_address__city STRING
shipping_step__ship_to__contact_address__country_code STRING
shipping_step__ship_to__contact_address__postal_code STRING
shipping_step__ship_to__contact_address__state_or_province STRING
shipping_step__ship_to__email STRING
shipping_step__ship_to__full_name STRING
shipping_step__ship_to__primary_phone__phone_number STRING
shipping_step__ship_to_reference_id STRING
shipping_step__shipping_carrier_code STRING
shipping_step__shipping_service_code STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
delivery_cost__discount_amount__currency STRING
delivery_cost__discount_amount__value STRING
delivery_cost__import_charges__currency STRING
delivery_cost__import_charges__value STRING
delivery_cost__shipping_cost__currency STRING
delivery_cost__shipping_cost__value STRING
delivery_cost__shipping_intermediation_fee__currency STRING
delivery_cost__shipping_intermediation_fee__value STRING
discounted_line_item_cost__currency STRING
discounted_line_item_cost__value STRING
ebay_collected_charges__ebay_shipping__currency STRING
ebay_collected_charges__ebay_shipping__value STRING
item_location__country_code STRING
item_location__location STRING
item_location__postal_code STRING
legacy_item_id STRING
legacy_variation_id STRING
line_item_cost__currency STRING
line_item_cost__value STRING
line_item_fulfillment_instructions__guaranteed_delivery BOOL
line_item_fulfillment_instructions__max_estimated_delivery_date STRING
line_item_fulfillment_instructions__min_estimated_delivery_date STRING
line_item_fulfillment_instructions__ship_by_date STRING
line_item_fulfillment_status STRING
line_item_id STRING
listing_marketplace_id STRING
properties__buyer_protection BOOL
properties__from_best_offer BOOL
properties__sold_via_ad_campaign BOOL
purchase_marketplace_id STRING
quantity FLOAT64
sku STRING
sold_format STRING
title STRING
total__currency STRING
total__value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__line_items__applied_promotions

Section titled “Subtable: orders__line_items__applied_promotions”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
description STRING
discount_amount__currency STRING
discount_amount__value STRING
promotion_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__line_items__ebay_collect_and_remit_taxes

Section titled “Subtable: orders__line_items__ebay_collect_and_remit_taxes”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
amount__currency STRING
amount__value STRING
collection_method STRING
ebay_reference__name STRING
ebay_reference__value STRING
tax_type STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__line_items__ebay_collected_charges__charges

Section titled “Subtable: orders__line_items__ebay_collected_charges__charges”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
amount__currency STRING
amount__value STRING
refund_date STRING
refund_id STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value JSON
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__line_items__variation_aspects

Section titled “Subtable: orders__line_items__variation_aspects”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
name STRING
value STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__payment_summary__payments

Section titled “Subtable: orders__payment_summary__payments”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
amount__currency STRING
amount__value STRING
payment_date STRING
payment_method STRING
payment_reference_id STRING
payment_status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

Subtable: orders__payment_summary__refunds

Section titled “Subtable: orders__payment_summary__refunds”
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
amount__currency STRING
amount__value STRING
refund_date STRING
refund_id STRING
refund_reference_id STRING
refund_status STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where eBay Fulfillment supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for eBay Fulfillment?

Section titled “How long does the initial sync take for eBay Fulfillment?”

It depends on how much history is in your eBay Fulfillment account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when eBay Fulfillment’s schema changes?

Section titled “What happens when eBay Fulfillment’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in eBay Fulfillment, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in eBay Fulfillment instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the eBay Fulfillment connector in Kaivo and all of its synced data is deleted with it.

Common use cases for eBay Fulfillment data

Section titled “Common use cases for eBay Fulfillment data”

Use orders to track sales volume and value over time.

Analyse orders to measure how quickly you ship and fulfil.

Join eBay orders with your other channels to compare marketplace performance.

Use eBay Fulfillment data in your AI and BI tools

Section titled “Use eBay Fulfillment data in your AI and BI tools”

Once eBay Fulfillment data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with eBay Fulfillment data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for eBay Fulfillment connector pricing and plan details.