Skip to main content

Shopify Error Messages

Shopify Error Messages

This article catalogs error messages you may encounter with the iPaaS.com Shopify integration and how to resolve them. These messages appear in the iPaaS.com error logs, typically prefixed with Unable to process transfer. Reason: …. Where a message contains values in braces (for example {Sku}) or brackets (for example [TAKEN]), Shopify or the integration fills in the specific record detail at runtime.

For any error whose cause is not clear from the message and resolution below, contact iPaaS.com Product Support.

Supported Flows

  • Connection & Authentication

  • Rate Limiting

  • Customer (TO / FROM iPaaS.com)

  • Company / B2B (TO / FROM iPaaS.com)

  • Product, Variant & Inventory (TO / FROM iPaaS.com)

  • Product Category & Collection (TO / FROM iPaaS.com)

  • Order (TO / FROM iPaaS.com)

  • Gift Card (TO / FROM iPaaS.com)

  • Location (Add/Update FROM iPaaS.com)

Connection & Authentication

Connection not configured

No API Url, API Key or API Store was specified for system {id}

  • Description: The subscription is missing one or more required connection settings, so the integration cannot reach Shopify.

  • Resolution: Open the Shopify subscription settings and confirm API Store, API Version, and the credentials for your authentication method (API Password for pre-April-2026 private apps, or Client Id + Client Secret for apps created after April 1, 2026) are populated. See Shopify Connections and Settings.

Unauthorized

Unauthorized error occurred. Error: {response}

  • Description: Shopify rejected the request as unauthorized — the access token/credentials are invalid or expired, or the app is missing a required access scope.

  • Resolution: Re-check the credentials in the subscription settings and confirm the Shopify app was installed with all required scopes (see Shopify Connections and Settings). Re-install or re-authorize the app if the token is no longer valid.

OAuth — Client Id or Client Secret missing

Unable to complete OAuth process in ProcessAuthorization. ClientId is not specified in the CustomFields for this SystemTypeVersion (and the equivalent ClientSecret message)

  • Description: An OAuth install was attempted but the Client Id and/or Client Secret were not provided in the subscription settings.

  • Resolution: Enter the app's Client Id and Client Secret in the Shopify subscription settings, then retry the installation.

OAuth — token exchange failed

Unable to complete OAuth process in ProcessAuthorization. Failed to convert temporary code into a permanent token / The specified authorization code was not found: {code} / Shopify token exchange failed ({status}): {response}

  • Description: Shopify could not be exchanged the temporary authorization code for a permanent access token — usually an expired/already-used code or a Client Id/Secret mismatch.

  • Resolution: Restart the app installation so a fresh authorization code is issued, and confirm the Client Id/Secret match the Shopify app. If it continues to fail, contact iPaaS.com Product Support.

Rate Limiting

Shopify API rate limit reached

Shopify API Quota Exception. Too Many Requests. Available in : {seconds}

  • Description: Shopify throttled the connection because too many API calls were made in a short window. The integration backs off and retries, but a large burst can still surface this.

  • Resolution: Usually transient — the transfer retries automatically. Avoid running multiple large manual syncs concurrently; stagger bulk jobs. If it persists, contact iPaaS.com Product Support.

Customer (TO / FROM iPaaS.com)

Customer create/update rejected by Shopify

Error while creating the customer in Shopify. {message} / Error while updating the customer in Shopify. {message}

  • Description: Shopify rejected the customer create/update; the appended message is the reason Shopify returned (for example an invalid email or phone format).

  • Resolution: Correct the indicated field on the iPaaS.com Customer and re-sync. If the message is unclear, contact iPaaS.com Product Support.

Customer prerequisite failed during order transfer

Unable to create customer. This will prevent the transfer of the order.

  • Description: An order references a customer that does not yet exist in the destination, and the automatic customer prerequisite transfer failed — so the order cannot proceed.

  • Resolution: Resolve the underlying customer error (it appears separately in the logs) and re-sync the order. Confirm the Customer mapping is configured correctly.

Customer email-link failure

Unable to dynamically link to existing iPaaS customer using email address. This will prevent the transfer of the order. (and Unable to transfer customer after dynamically linking on email address.)

  • Description: Shopify rejected a duplicate-email customer create, and the integration could not link to / transfer the existing customer to recover.

  • Resolution: Confirm the customer's email is valid and that the existing customer record is healthy in both systems, then re-sync. If unclear, contact iPaaS.com Product Support.

Company / B2B (TO / FROM iPaaS.com)

Company create/update rejected by Shopify

Error while creating the company in Shopify / Error while updating the company in Shopify

  • Description: Shopify rejected the B2B company create/update. B2B must be enabled on the store (see Shopify Known Limitations).

  • Resolution: Confirm B2B is enabled and the company Name is valid, then re-sync. If unclear, contact iPaaS.com Product Support.

Company contact (customer) prerequisite failed

Unable to create company customer in HandlePrerequisite. This will prevent the transfer of the company. / Unable to create customer company in HandlePrerequisite. This will prevent the transfer of the customer.

  • Description: A company (or customer-company relationship) depends on a related customer that could not be transferred as a prerequisite, so the parent transfer fails.

  • Resolution: Resolve the related customer error (logged separately) and re-sync. Confirm the Customer mapping is configured correctly.

Company link failure (duplicate risk)

Unable to dynamically link to existing iPaaS Company using name & external_id. This may result in duplicate company records. (and the using Id variants)

  • Description: The integration tried to link an incoming company to an existing record by name/id and could not save the link, which risks creating a duplicate.

  • Resolution: Check whether a matching company already exists and whether the Allow Creating Duplicate Companies setting is intended (see Shopify Connections and Settings). If a duplicate appears, merge it manually. If unclear, contact iPaaS.com Product Support.

Product, Variant & Inventory (TO / FROM iPaaS.com)

Product create/update failed

Product can't create, kindly see logs / Product can't update, kindly see logs / Product can not update, kindly see logs

  • Description: The product transfer to Shopify failed; the detailed reason is in the transfer's technical logs.

  • Resolution: Open the transfer's logs for the specific Shopify error, correct the indicated data on the iPaaS.com Product, and re-sync. If the cause is unclear, contact iPaaS.com Product Support.

Variant missing required option

Unable to upload product to Shopify. Variant does not have one of the following Option1 or Option2 or Option3, which is required => {variant} (and Error in transfer because variant doesn't contain any option: {sku})

  • Description: Shopify requires every variant to define at least one option value. A variant was sent with no option, so the product cannot be created.

  • Resolution: Ensure each variant on the iPaaS.com Product has at least one option value (for example Size or Color), then re-sync.

Product variant limit exceeded

Transfer cannot proceed: Your store allows a maximum of {max} product variants. The current transfer includes {count} variants, which exceeds this limit.

  • Description: The product has more variants than the store's Shopify plan allows.

  • Resolution: Reduce the number of variants on the product, or upgrade the Shopify plan's variant limit, then re-sync.

Variant bulk operation returned no id

Null Id of Variant is received from Shopify Bulk Variant Create API / Null Id of Variant is received from Shopify Bulk Variant Update API / Variants did not transfer due to this error {message}

  • Description: Shopify's bulk variant operation did not return an id for a variant, so the variant could not be linked/completed.

  • Resolution: Re-sync the product. If it recurs, capture the logged Shopify response and contact iPaaS.com Product Support.

Inventory update failed

Error while updating inventory due to {message} / Error while updating a inventory level of Id:{InventoryId}|{LocationId} Exception: {message}

  • Description: Shopify rejected an inventory-level update — commonly because the location is not linked or inventory is not tracked at that location.

  • Resolution: Confirm the location is synced/linked and inventory tracking is enabled for the item at that location, then re-sync. If unclear, contact iPaaS.com Product Support.

Product Category & Collection (TO / FROM iPaaS.com)

Category prerequisite failed during product transfer

Unable to create product category in HandlePrerequisite. This will prevent the transfer of the product.

  • Description: A product references a category/collection that could not be created as a prerequisite, so the product transfer fails.

  • Resolution: Resolve the underlying category error (logged separately) and re-sync the product.

Collection update missing id

Collection can not be updated because collection id is null/empty: {detail}

  • Description: An update was attempted for a collection that is not linked to a Shopify collection id.

  • Resolution: Sync the category once so it is created/linked in Shopify before updating it.

Assignment delete — wrong id format

Product Category Assignment Delete Attempt Failed: The supplied id was not in the correct format. It should be <product_id>|<category_id>. Id={value}

  • Description: A Product Category Assignment delete was sent with a Manual Sync id that is not the required <ProductId>|<AssignmentId> form.

  • Resolution: Use the pipe-joined id format on the Manual Sync page (see the Product Category Assignment mapping documentation).

Category/Product/Variant link failure (duplicate risk)

Unable to dynamically link to existing {Shopify} Collection / Product Id / Variant Id … This may result in duplicate records.

  • Description: The integration matched an existing Shopify record by name/SKU/title but could not save the external-id link, which risks a duplicate.

  • Resolution: Check for an existing matching record; if a duplicate is created, remove it manually. If it recurs, contact iPaaS.com Product Support.

Order (TO / FROM iPaaS.com)

Order create/update returned no data

Order creation failed; no order data returned from Shopify. / Order update failed; no order data returned from Shopify.

  • Description: Shopify accepted the call but returned no order payload, so the integration could not confirm or link the order.

  • Resolution: Re-sync the order. If it recurs, capture the logged Shopify response and contact iPaaS.com Product Support.

Order line-item product prerequisite failed

Unable to transfer transaction line item's product (Sku: {sku}) in HandlePrerequisite. This will prevent the transfer of this transaction (transactionNumber: {number})

  • Description: An order line item references a product that could not be created in Shopify as a prerequisite (this runs when Create Line Item Product as Prerequisite is enabled), so the order fails.

  • Resolution: Resolve the underlying product error (logged separately), confirm the product data is valid, and re-sync the order.

Order link failure (duplicate risk)

Unable to dynamically link to existing Shopify Order (iPaaS Transaction) using transaction number. This may result in duplicate orders.

  • Description: The integration tried to match an existing Shopify order by the transaction-number metafield and could not save the link, risking a duplicate order.

  • Resolution: Confirm the Shopify Metafield for Transaction Number Matching setting points at the correct metafield and that it exists and is filterable in Shopify (see Shopify Connections and Settings). If a duplicate appears, cancel it in Shopify.

Payment transactions not found

Unable to locate payment transactions for this order

  • Description: The order has no payment transactions available to map.

  • Resolution: Confirm the order actually has payment data in the source; if a payment mapping is required for your flow, ensure the source order includes it.

Gift Card (TO / FROM iPaaS.com)

Gift card missing id

No Id assigned to gift card. iPaaS does not compute.

  • Description: A gift card was processed without a Shopify gift card id, so it cannot be linked or updated.

  • Resolution: Confirm the gift card exists in Shopify and the connection has the read_gift_cards scope (requested from Shopify Support). See Shopify Known Limitations for gift-card constraints.

Add/Update Shopify Location FROM iPaaS.com

Duplicate location name

Unable to process transfer. Reason: Shopify.locationAdd failed: [TAKEN] input.name: You already have a location with this name

  • Description: Shopify enforces unique location names, including across deactivated locations. When the integration tries to create a location whose name already exists in Shopify, Shopify rejects the create with the [TAKEN] code on input.name.

  • Resolution: This collection's collision handling is set to Update and Link, which recovers from this automatically — the integration finds the existing Shopify location by its exact name (including deactivated locations), links it by saving its id as the external id, and completes the transfer as an update instead of creating a duplicate. If you still see this error, either the collision-handling method is not set to Update and Link or no exact name match was found (matching is case-insensitive but otherwise exact). Confirm the collision method on the mapping collection and that the iPaaS.com Location name matches the Shopify location name exactly.

Country code required

Unable to process transfer. Reason: Shopify.LocationManager.PostLocationGraphQL: CountryCode is required but was not provided.

  • Description: Shopify requires a country to create or update a location. This error means the iPaaS.com Location's address country did not resolve to a value the integration could send — the CountryCode mapping was empty. The same message appears for updates (with PutLocationGraphQL).

  • Resolution: Set the iPaaS.com Location address country to a value Shopify recognizes, and confirm the CountryCode mapping (sourced from the address country) is populated.

Location create rejected

Unable to process transfer. Reason: Shopify.locationAdd failed: [CODE] field: message

  • Description: Shopify rejected the create for a reason other than a duplicate name. The bracketed [CODE], field, and message are returned by Shopify and identify the problem — for example, an unrecognized country.

  • Resolution: Read the [CODE] / field / message and correct the indicated value on the iPaaS.com Location. For [TAKEN] on the name, see Duplicate location name above. If the cause is unclear, contact iPaaS.com Product Support.

Location update rejected

Unable to process transfer. Reason: Shopify.locationEdit failed: [CODE] field: message

  • Description: Shopify rejected an update to a linked location. The bracketed details are returned by Shopify and identify the field and reason.

  • Resolution: Correct the indicated field on the iPaaS.com Location and re-sync. If the cause is unclear, contact iPaaS.com Product Support.

Location activation failed

Unable to process transfer. Reason: Shopify.locationActivate failed: [CODE] field: message

  • Description: The integration tried to reactivate a deactivated Shopify location before updating it, and Shopify rejected the activation. The locationActivate mutation requires Shopify Admin GraphQL API version 2026-04 (for the @idempotent directive).

  • Resolution: Ensure the Shopify connection's API Version is 2026-04 or later (see Shopify Known Limitations). Read the [CODE] / message; if the cause is unclear, contact iPaaS.com Product Support.

Related Articles
Linnworks Error Messages
Akeneo Integration Error Messages
NetSuite Error Messages
iPaaS.com to Shopify Order Mapping Documentation
PayFabric Error Messages
Did this answer your question?