The integration will connect to Squarespace at regular intervals to check for waiting orders that have not been previously fulfilled or set to a Fulfilled status. 

Fulfilling New Orders

Each time we connect to Squarespace to retrieve new orders, we request only orders within the History range you have set in your integration settings in the EFS Fullfillment Control Panel.  Orders older than that range will be ignored.

Orders containing only products of the Digital, Service, or Gift Card type will be ignored entirely.  Those orders containing both Physical products and products of another type will ignore the non-physical items, or any items without matching or mapped skus in the FCP.

Shipment & Tracking Updates

At the end of each day we will send tracking numbers back to Squarespace, for orders shipped that day, and update items as shipped.



Connecting EFS & Squarespace

Step 1: API Key Generation

To integrate Squarespace with eFulfillment Service requires generating an API key in Squarespace which will allow our Integration Portal to connect with your cart.  In order to generate an API key, you’ll first want to go to Settings in your Squarespace navigation bar, and then click on API Keys:

Once you click on “Create Key,” you will be prompted to choose a name for the API Key which will tell you what apps are using it, for which you might choose “EFS.”  Then you should confirm that the scope for the API has the ability to send order data and mark orders as fulfilled.

Finally, Squarespace will display your API Key, which you should copy in order to paste into our Integration Portal:

Step 2: Creating Your Integration in Our Integration Portal

In order to create an integration in the Integration Portal, you’ll first need to navigate to the Integrations section of the portal, and click on the blue “+ Add” button in the top right:


Select Squarespace from the list of available integrations, which will bring up the integration configuration page:

You will need to fill out the available fields with the following information:

Integration Name: Pick a name which will help connect the integration to your store.  You can use letters and numbers, but no spaces or special characters.

WMS Target: Pick the WMS you would like to connect your shop to; for most users, you will have only one WMS(the FCP) which will have been configured by your Client Care representative.

Order/Inventory Sync Schedule: Indicate how frequently you would like data sent to and from your Squarespace cart by selecting an option from the dropdown menus.(Note, Squarespace does not allow for inventory syncing, so this setting is unnecessary)

Access Token: This is where you will paste the API Key you generated in Step 1.

History: We only pull orders that are a specific number of days old in order to prevent attempting to pull old orders that do not need to come through.  The number you enter in this field will be the number of days backward that we attempt to sync orders.

Finally, hit the “Save Integration” button at the bottom of the form, and your integration will be created and visible on your Integrations page:


Step 3: Product Setup

When setting up products in Squarespace, you need to take note of the product SKU (which can differ from the product name), as this is how the item will be identified by the integration.  These will be shown in the Pricing & Variants section of the product's creation/edit page.

The Squarespace API does not offer any method of determining product listings or product details, which prevents us from populating the cart items page which allows us to map items to the SKUs in the FCP.  If you need to map an item in your cart to items in the FCP for the purposes of fulfilling a bundle or linking an item with a different SKU to a SKU in the FCP, you will have to create a custom item on the cart items page to fulfill this purpose.   You can do this by navigating to the Cart Items section in your integration config, and clicking on the “+ Add Custom Item” button:

This will bring up the following form:

The item name can be whatever description of the item or other name you wish to identify the item by, but the Item SKU must match exactly the value of the SKU you wish to map in Squarespace, found as noted above in the Pricing and Variants section of the product info.  The declared value field is unnecessary.  Click the “+ Add” button, and you will see the custom item on your Cart Items page:

You will now be able to add a SKU Map to this SKU, allowing you to map this item to several different items we should fulfill when this item appears in your orders.

Step 4: Shipping Methods

When we retrieve your orders from Squarespace the shipping methods are shown as strings of text such as “Default” or “Free Shipping”. This text needs to be translated to our internal codes by setting up mappings within the integration configuration.  To do this, you will first need to know what shipping method codes you have set up in Squarespace.  To find this, go to the Store Settings menu and click on Shipping.

From here you can set up additional shipping methods in your Squarespace cart.  You can name these whatever you like, but please take note of the methods and their names.  Note: The shipping costs mentioned during the shipping method setup within Squarespace do not pertain to actual costs of shipping through EFS in any way, but will be applied to the orders made by your customers.

Once you have your shipping codes from Squarespace, you can navigate to the Ship Maps section of your integration config, and click the “+ New Ship Map” button to set up a new ship mapping:

To add a ship mapping, you must fill out the Cart Method and WMS Shipping Code fields at a minimum.  The Cart Method field should be filled with the shipping method name you copied from Squarespace.  You should input the cart method exactly as it appears in Squarespace.  The WMS Shipping Code field is a dropdown with all the available shipping methods EFS supports.  Select the shipping method you would like to map to the code from Squarespace.  You can also optionally request required signatures for ship methods that support that, and for us to hold orders with this ship method to allow time for fraud screening.  When you are done, click “Save” at the bottom, and your ship mapping will be complete.

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk