We value your privacy

We use cookies to enhance your browsing experience, serve personalised ads or content, and analyse our traffic. By clicking "Accept All", you consent to our use of cookies.

CustomiseReject AllAccept All

Customise Consent Preferences

We use cookies to help you navigate efficiently and perform certain functions. You will find detailed information about all cookies under each consent category below.

The cookies that are categorised as "Necessary" are stored on your browser as they are essential for enabling the basic functionalities of the site. ... Show more

NecessaryAlways Active

Necessary cookies are required to enable the basic features of this site, such as providing secure log-in or adjusting your consent preferences. These cookies do not store any personally identifiable data.

- Cookie

cookieyes-consent

- Duration

1 year

- Description

CookieYes sets this cookie to remember users' consent preferences so that their preferences are respected on subsequent visits to this site. It does not collect or store any personal information about the site visitors.

Functional

Functional cookies help perform certain functionalities like sharing the content of the website on social media platforms, collecting feedback, and other third-party features.

- Cookie

ytidb::LAST\_RESULT\_ENTRY\_KEY

- Duration

Never Expires

- Description

The cookie ytidb::LAST\_RESULT\_ENTRY\_KEY is used by YouTube to store the last search result entry that was clicked by the user. This information is used to improve the user experience by providing more relevant search results in the future.

- Cookie

yt-remote-device-id

- Duration

Never Expires

- Description

YouTube sets this cookie to store the user's video preferences using embedded YouTube videos.

- Cookie

yt-remote-connected-devices

- Duration

Never Expires

- Description

YouTube sets this cookie to store the user's video preferences using embedded YouTube videos.

- Cookie

yt-remote-session-app

- Duration

session

- Description

The yt-remote-session-app cookie is used by YouTube to store user preferences and information about the interface of the embedded YouTube video player.

- Cookie

yt-remote-cast-installed

- Duration

session

- Description

The yt-remote-cast-installed cookie is used to store the user's video player preferences using embedded YouTube video.

- Cookie

yt-remote-session-name

- Duration

session

- Description

The yt-remote-session-name cookie is used by YouTube to store the user's video player preferences using embedded YouTube video.

- Cookie

yt-remote-fast-check-period

- Duration

session

- Description

The yt-remote-fast-check-period cookie is used by YouTube to store the user's video player preferences for embedded YouTube videos.

Analytics

Analytical cookies are used to understand how visitors interact with the website. These cookies help provide information on metrics such as the number of visitors, bounce rate, traffic source, etc.

- Cookie

\_ga\_\*

- Duration

1 year 1 month 4 days

- Description

Google Analytics sets this cookie to store and count page views.

- Cookie

\_ga

- Duration

1 year 1 month 4 days

- Description

Google Analytics sets this cookie to calculate visitor, session and campaign data and track site usage for the site's analytics report. The cookie stores information anonymously and assigns a randomly generated number to recognise unique visitors.

Performance

Performance cookies are used to understand and analyse the key performance indexes of the website which helps in delivering a better user experience for the visitors.

No cookies to display.

Advertisement

Advertisement cookies are used to provide visitors with customised advertisements based on the pages you visited previously and to analyse the effectiveness of the ad campaigns.

- Cookie

YSC

- Duration

session

- Description

Youtube sets this cookie to track the views of embedded videos on Youtube pages.

- Cookie

VISITOR\_INFO1\_LIVE

- Duration

6 months

- Description

YouTube sets this cookie to measure bandwidth, determining whether the user gets the new or old player interface.

- Cookie

VISITOR\_PRIVACY\_METADATA

- Duration

6 months

- Description

YouTube sets this cookie to store the user's cookie consent state for the current domain.

- Cookie

yt.innertube::requests

- Duration

Never Expires

- Description

YouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.

- Cookie

yt.innertube::nextId

- Duration

Never Expires

- Description

YouTube sets this cookie to register a unique ID to store data on what videos from YouTube the user has seen.

Uncategorised

Other uncategorised cookies are those that are being analysed and have not been classified into a category as yet.

- Cookie

\_reb2bloaded

- Duration

Less than a minute

- Description

Description is currently not available.

- Cookie

\_reb2buid

- Duration

1 year

- Description

Description is currently not available.

- Cookie

\_reb2bsessionID

- Duration

1 hour

- Description

Description is currently not available.

- Cookie

\_reb2bgeo

- Duration

20 days

- Description

Description is currently not available.

Reject All  Save My Preferences  Accept All

Powered by

[Skip to content](https://kodif.ai/blog/tool/shopify/#content)

[Register](https://www.linkedin.com/events/7475995398487138304/?viewAsMember=true) for our webinar!

[Register](https://www.linkedin.com/events/7475995398487138304/?viewAsMember=true) for our webinar!

# Shopify

Shopify powers storefronts and orders. With KODIF, you can retrieve orders by ID/name/email, get fulfillment status, update order or customer addresses, cancel orders, and send password recovery emails.

## Integration Actions

##### Shopify - Add Fixed Discount via Order Editing

Add a fixed amount discount in an order using Order Editing GraphQL Mutation.

##### Shopify - Add Percentage Discount via Order Editing

Add a percentage discount in an order using Order Editing GraphQL Mutation.

##### Shopify - Add Tag

Adds a tag to a Shopify order to help organize and track order status or characteristics.

This integration allows you to add custom tags to Shopify orders for b... [Read More](https://kodif.ai/blog/tool/shopify/#)

Adds a tag to a Shopify order to help organize and track order status or characteristics.

This integration allows you to add custom tags to Shopify orders for better organization and tracking. Tags are useful for categorizing orders by status, special conditions, or business processes – like marking orders as “expedited”, “gift-order”, or “customer-service-handled”.

* * *

###### Parameters

- **order\_id** ( _String_): The unique Shopify order ID number that you want to tag. Example: “8234567891234”.
- **tag** ( _String_): The tag text you want to add to the order. Example: “priority-shipping”.

* * *

###### Output

Returns confirmation of the tag addition along with the order’s complete list of tags. The response includes the **id** (the Shopify order ID in GraphQL format), **tags** (array of all current tags on the order), and **userErrors** (array that shows any issues, or empty if successful).

Example Output:

```
{
  "data": {
    "tagsAdd": {
      "node": {
        "id": "gid://shopify/Order/8234567891234",
        "tags": [\
          "priority-shipping",\
          "customer-requested",\
          "express-delivery"\
        ]
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19990
      },
      "actualQueryCost": 10,
      "requestedQueryCost": 10
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Cancel Order (GraphQL)

Cancels a Shopify order with options for refunding and restocking inventory items.

This integration cancels an existing order in your Shopify store using Shopif... [Read More](https://kodif.ai/blog/tool/shopify/#)

Cancels a Shopify order with options for refunding and restocking inventory items.

This integration cancels an existing order in your Shopify store using Shopify’s GraphQL API. When you cancel an order, you can choose whether to automatically refund the customer and whether to restock the items back into your inventory. The cancellation is processed as a background job, so you’ll receive a job ID to track the progress.

* * *

###### Parameters

- **admin\_graphql\_api\_id** ( _String_): The unique GraphQL identifier of the order you want to cancel. Must be in the format “gid://shopify/Order/\[order\_number\]”. Example: “gid://shopify/Order/8429365742891”.
- **reason** ( _String_): The reason for canceling the order. Accepted values include “CUSTOMER” (customer requested), “FRAUD” (fraudulent order), “INVENTORY” (out of stock), “DECLINED” (payment declined), or “OTHER”. Example: “CUSTOMER”.
- **refund** ( _Boolean_): Whether to automatically refund the customer’s payment when canceling. Use true to issue a refund, false to cancel without refunding. Example: true.
- **restock** ( _Boolean_): Whether to return the canceled items back to your inventory. Use true to restock items, false to keep inventory unchanged. Example: true.

* * *

###### Output

Returns a cancellation response containing a **job** object with the background job details, and an **orderCancelUserErrors** array that lists any validation errors that prevented the cancellation. The job object includes an **id** for tracking and a **done** status indicating if the cancellation completed immediately.

Example Output:

```
{
  "data": {
    "orderCancel": {
      "job": {
        "id": "gid://shopify/Job/a8c2f619-3471-4892-b765-9e40cd875214",
        "done": false
      },
      "orderCancelUserErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19990
      },
      "actualQueryCost": 10,
      "requestedQueryCost": 10
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Cancel Order by ID

Cancels a Shopify order using the order ID and marks it as cancelled in the system.

This integration cancels an existing order in Shopify by sending a cancellat... [Read More](https://kodif.ai/blog/tool/shopify/#)

Cancels a Shopify order using the order ID and marks it as cancelled in the system.

This integration cancels an existing order in Shopify by sending a cancellation request to the specified order ID. When executed, it changes the order status to cancelled, sets the cancellation timestamp, and may trigger inventory restocking depending on your Shopify settings. This is useful when customers request order cancellations or when you need to cancel orders that cannot be fulfilled.

* * *

###### Parameters

- **order\_id** ( _String/ID_): The unique Shopify order ID that you want to cancel. Example: “7024926130367”.

* * *

###### Output

Returns the complete updated order object showing its cancelled status. Key fields include **id** (order ID), **cancelled\_at** (cancellation timestamp), **cancel\_reason** (reason for cancellation), **financial\_status** (payment status after cancellation), **fulfillment\_status** (fulfillment status after cancellation), along with all original order details like customer information, line items, pricing, and shipping details. The response also includes a **notice** field confirming the cancellation.

Example Output:

```
{
  "order": {
    "id": 8392847205183,
    "name": "#1425678",
    "cancelled_at": "2026-03-25T14:22:18-04:00",
    "cancel_reason": "other",
    "financial_status": "paid",
    "fulfillment_status": null,
    "email": "sarah.martinez@example.com",
    "total_price": "42.67",
    "currency": "USD",
    "customer": {
      "id": 9847362518975,
      "email": "sarah.martinez@example.com",
      "first_name": "Sarah",
      "last_name": "Martinez"
    },
    "line_items": [\
      {\
        "id": 16284759382847,\
        "name": "Snap Grip - Ocean Blue",\
        "quantity": 1,\
        "price": "29.99"\
      }\
    ]
  },
  "notice": "Order has been canceled"
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Create a New Order from the Draft Order

Converts a Shopify draft order into a live, active order that customers can purchase and you can fulfill.

This integration takes an existing draft order in Shop... [Read More](https://kodif.ai/blog/tool/shopify/#)

Converts a Shopify draft order into a live, active order that customers can purchase and you can fulfill.

This integration takes an existing draft order in Shopify and completes it, transforming it from a draft state into a live order. Draft orders are preliminary orders that merchants create but haven’t been finalized yet. Once completed, the draft order becomes a regular order that appears in your order management system and can be processed for fulfillment and payment.

* * *

###### Parameters

- **draftOrderID** ( _String_): The unique Shopify draft order identifier that you want to convert to a live order. Must be in the format “gid://shopify/DraftOrder/\[number\]”. Example: “gid://shopify/DraftOrder/1234567890123”.

* * *

###### Output

Returns the completion status and details of both the original draft order and the newly created live order. Key fields include the draft order **id** and **status** (which becomes “COMPLETED”), plus the new order’s **id**, **name** (order number), and **displayFinancialStatus** (payment status). If there are any validation errors, they appear in the **userErrors** array.

Example Output:

```
{
  "data": {
    "draftOrderComplete": {
      "draftOrder": {
        "id": "gid://shopify/DraftOrder/1234567890123",
        "order": {
          "id": "gid://shopify/Order/9876543210987",
          "name": "#8472951",
          "displayFinancialStatus": "PAID"
        },
        "status": "COMPLETED"
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19989
      },
      "actualQueryCost": 11,
      "requestedQueryCost": 11
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Create Draft Replacement Order

Creates a draft replacement order in Shopify based on an existing order for easy reordering or order modifications.

This integration creates a new draft order i... [Read More](https://kodif.ai/blog/tool/shopify/#)

Creates a draft replacement order in Shopify based on an existing order for easy reordering or order modifications.

This integration creates a new draft order in Shopify using all the details from an existing order. This is useful when customers want to reorder the same items, when you need to create a replacement order for damaged goods, or when you want to modify an order before finalizing it. The draft order can be edited, adjusted, and then converted to a regular order when ready.

* * *

###### Parameters

- **orderID** ( _String_): The unique identifier of the existing Shopify order to copy. This should be the numeric order ID. Example: “8429157342856”.

* * *

###### Output

Returns a draft order object containing the new draft order’s **id** (Shopify’s internal GraphQL ID) and **name** (the draft order number that appears in the Shopify admin). If there are any validation errors, they will appear in the **userErrors** array with details about what went wrong.

Example Output:

```
{
  "data": {
    "draftOrderCreateFromOrder": {
      "draftOrder": {
        "id": "gid://shopify/DraftOrder/2847193856492",
        "name": "#D2847659"
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19990
      },
      "actualQueryCost": 10,
      "requestedQueryCost": 10
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Create Order 20$ Refund

Creates a $20 refund for a Shopify order through the specified payment gateway.

This integration processes a $20 refund for a specific Shopify order by creating... [Read More](https://kodif.ai/blog/tool/shopify/#)

Creates a $20 refund for a Shopify order through the specified payment gateway.

This integration processes a $20 refund for a specific Shopify order by creating a refund transaction through the original payment gateway. It sends a customer notification about the refund and allows you to include a note explaining the reason for the refund. The refund is processed as a new transaction linked to the original order payment.

* * *

###### Parameters

- **order\_id\_to\_refund** ( _String_): The Shopify order ID that needs to be refunded, in Shopify’s Global ID format. Example: “gid://shopify/Order/7654321098765”
- **transaction\_id** ( _String_): The parent transaction ID from the original payment, in Shopify’s Global ID format. Example: “gid://shopify/OrderTransaction/9876543210987”
- **gateway\_of\_refund** ( _String_): The payment gateway to process the refund through (must match the original payment method). Example: “shopify\_payments”
- **refund\_note** ( _String_): Optional note explaining the reason for the refund. Example: “Customer requested refund due to sizing issue”

* * *

###### Output

Returns the created refund details including the unique **refund ID**, **total refunded amount** with **currency code**, and any **user errors** if the refund failed. The response also includes GraphQL cost information for API usage tracking.

Example Output:

```
{
  "data": {
    "refundCreate": {
      "refund": {
        "id": "gid://shopify/Refund/2020445567890",
        "totalRefundedSet": {
          "presentmentMoney": {
            "amount": "20.0",
            "currencyCode": "USD"
          }
        }
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19980
      },
      "actualQueryCost": 20,
      "requestedQueryCost": 20
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Create Order Refund by Percentage

Creates a percentage-based refund for a Shopify order with calculated refund amounts and automatic customer notifications.

This integration processes refunds fo... [Read More](https://kodif.ai/blog/tool/shopify/#)

Creates a percentage-based refund for a Shopify order with calculated refund amounts and automatic customer notifications.

This integration processes refunds for Shopify orders using a percentage-based calculation system. It creates an official refund record in Shopify, automatically notifies the customer via email, and processes the transaction through the original payment gateway. The tool calculates the exact refund amount based on your specified percentage of the original order value.

* * *

###### Parameters

- **order\_id\_to\_refund** ( _String_): The Shopify order ID that needs to be refunded, in Shopify’s Global ID format. Example: “gid://shopify/Order/7456123789012”.
- **transaction\_id** ( _String_): The ID of the original payment transaction, used to link the refund to the correct payment. Example: “gid://shopify/OrderTransaction/9876543210123”.
- **total\_amount\_to\_be\_refunded\_based\_on\_tool\_oficial\_calculation** ( _String or Number_): The calculated refund amount in the order’s currency. Example: “45.75”.
- **gateway\_of\_refund** ( _String_): The payment gateway that will process the refund (must match the original payment method). Example: “shopify\_payments”.
- **refund\_note** ( _String, Optional_): Internal note explaining the reason for the refund. Example: “Customer satisfaction refund for product quality issue”.

* * *

###### Output

Returns a refund confirmation object containing the new **refund ID**, **totalRefundedSet** with amount and currency details, and any **userErrors** if the refund failed. The response also includes Shopify’s API cost information for rate limiting purposes.

Example Output:

```
{
  "data": {
    "refundCreate": {
      "refund": {
        "id": "gid://shopify/Refund/2047891456789",
        "totalRefundedSet": {
          "presentmentMoney": {
            "amount": "0.0",
            "currencyCode": "USD"
          }
        }
      },
      "userErrors": []
    }
  },
  "extensions": {
    "cost": {
      "throttleStatus": {
        "restoreRate": 1000.0,
        "maximumAvailable": 20000.0,
        "currentlyAvailable": 19980
      },
      "actualQueryCost": 20,
      "requestedQueryCost": 20
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Find Customer by Phone Number

Searches Shopify for a customer record using their phone number to retrieve profile details and purchase history.

This integration searches your Shopify store f... [Read More](https://kodif.ai/blog/tool/shopify/#)

Searches Shopify for a customer record using their phone number to retrieve profile details and purchase history.

This integration searches your Shopify store for customers that match a specific phone number, giving you quick access to their complete profile including contact information, order history, spending totals, and account status. Perfect for customer service teams who need to look up customers when they call in or text for support.

* * *

###### Parameters

- **phone** ( _String_): The customer’s phone number to search for. Should include country code format. Example: “+1-555-123-4567”.

* * *

###### Output

Returns a customer object containing the customer’s **id**, **firstName**, **lastName**, **email**, **phone**, account **state** (enabled/disabled), **numberOfOrders**, **amountSpent** with currency, **verifiedEmail** status, **taxExempt** status, **lifetimeDuration** as a customer, and **validEmailAddress** indicator.

Example Output:

```
{
  "data": {
    "customers": {
      "nodes": [{\
        "id": "gid://shopify/Customer/8284423553109",\
        "firstName": "Sarah",\
        "lastName": "Johnson",\
        "email": "sarah.johnson@example.com",\
        "phone": "+1-555-234-5678",\
        "state": "ENABLED",\
        "numberOfOrders": "3",\
        "amountSpent": {\
          "amount": "142.75",\
          "currencyCode": "USD"\
        },\
        "verifiedEmail": true,\
        "taxExempt": false,\
        "lifetimeDuration": "6 months",\
        "validEmailAddress": true\
      }]
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Cancelled Orders

Shopify Retrieves Cancelled Orders using Shopify. No inputs are required. Returns results based on the executed action.

##### Shopify - Get Customer by Email

Looks up a Shopify customer record using an email address to retrieve their profile information and contact details.

This integration searches your Shopify stor... [Read More](https://kodif.ai/blog/tool/shopify/#)

Looks up a Shopify customer record using an email address to retrieve their profile information and contact details.

This integration searches your Shopify store for a customer that matches the email address you provide. It returns the customer’s complete profile including their name, contact information, order history, marketing preferences, and account status. This is useful for customer service teams who need to quickly pull up customer details during support interactions.

* * *

###### Parameters

- **email** ( _String (email)_): The customer’s email address to search for. Must be a valid email format. Example: “sarah.martinez@example.com”.

* * *

###### Output

Returns a complete Shopify customer object containing **id**, **email**, **first\_name**, **last\_name**, **phone**, **state** (account status), **total\_spent**, **orders\_count**, **tags**, **addresses** array, **verified\_email** status, **email\_marketing\_consent** preferences, and timestamps for **created\_at** and **updated\_at**. If no customer is found, returns an empty result.

Example Output:

```
{
  "id": 8547392851743,
  "email": "sarah.martinez@example.com",
  "first_name": "Sarah",
  "last_name": "Martinez",
  "phone": "+1-555-234-5678",
  "state": "enabled",
  "currency": "USD",
  "total_spent": "245.50",
  "orders_count": 3,
  "tags": "vip,loyal_customer",
  "verified_email": true,
  "tax_exempt": false,
  "addresses": [],
  "created_at": "2024-03-15T14:22:31-05:00",
  "updated_at": "2024-12-20T09:15:42-05:00",
  "email_marketing_consent": {
    "state": "subscribed",
    "opt_in_level": "single_opt_in",
    "consent_updated_at": "2024-03-15T14:22:31-05:00"
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer by Email

Looks up a Shopify customer record using an email address to retrieve their complete profile and account information.

This integration searches your Shopify sto... [Read More](https://kodif.ai/blog/tool/shopify/#)

Looks up a Shopify customer record using an email address to retrieve their complete profile and account information.

This integration searches your Shopify store for a customer that matches the email address you provide. It returns the customer’s complete profile including their name, contact information, order history, account status, marketing preferences, addresses, and spending details. This is essential for customer service teams who need to quickly access customer information during support interactions or account inquiries.

* * *

###### Parameters

- **email** ( _String (email)_): The customer’s email address to search for. Must be a valid email format. Example: “sarah.martinez@example.com”.

* * *

###### Output

Returns a complete Shopify customer object containing **id**, **email**, **first\_name**, **last\_name**, **phone**, **state** (enabled/disabled), **currency**, **total\_spent**, **orders\_count**, **tags**, **addresses** array with full address details, **default\_address**, **verified\_email** status, **tax\_exempt** status, **last\_order\_id**, **last\_order\_name**, **email\_marketing\_consent** and **sms\_marketing\_consent** preferences, plus timestamps for **created\_at** and **updated\_at**.

Example Output:

```
{
  "id": 8555064426592,
  "email": "sarah.martinez@example.com",
  "first_name": "Sarah",
  "last_name": "Martinez",
  "phone": null,
  "state": "enabled",
  "currency": "USD",
  "total_spent": "74.83",
  "orders_count": 1,
  "tags": "Active product subscription, Login with Shop, Placed Order, Shop",
  "verified_email": true,
  "tax_exempt": false,
  "last_order_id": 6311912472672,
  "last_order_name": "#1521851",
  "created_at": "2024-02-28T06:45:22-08:00",
  "updated_at": "2024-03-22T15:10:27-07:00",
  "default_address": {
    "id": 8918595993696,
    "name": "Sarah Martinez",
    "first_name": "Sarah",
    "last_name": "Martinez",
    "address1": "456 Oak Street",
    "city": "Portland",
    "province": "Oregon",
    "country": "United States",
    "zip": "97205",
    "phone": "+1-555-234-5678",
    "country_code": "US",
    "province_code": "OR",
    "default": true
  },
  "email_marketing_consent": {
    "state": "subscribed",
    "opt_in_level": "single_opt_in",
    "consent_updated_at": "2024-02-28T06:45:27-08:00"
  },
  "sms_marketing_consent": {
    "state": "not_subscribed",
    "opt_in_level": "single_opt_in",
    "consent_updated_at": null
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer by Email with basic information

Searches for a Shopify customer using their email address and returns their profile information including order history.

This integration searches your Shopify ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Searches for a Shopify customer using their email address and returns their profile information including order history.

This integration searches your Shopify store for a customer that matches the email address you provide. It returns comprehensive customer profile information including contact details, order history, spending totals, and default shipping address, making it easy for your team to quickly access complete customer information.

* * *

###### Parameters

- **email** ( _String (email)_): Customer email address to search for. Example: “sarah.johnson@example.com”.

* * *

###### Output

Returns an array containing the matching customer’s complete profile with fields including **customer\_id**, **email**, **first\_name**, **last\_name**, **phone**, **default\_address** (with address1, city, province, zip, country), **orders\_count**, **total\_spent**, **last\_order\_name**, **created\_at**, **updated\_at**, and **customer\_graphql\_api\_id**.

Example Output:

```
[{\
  "email": "sarah.johnson@example.com",\
  "phone": "+1-555-0123",\
  "last_name": "Johnson",\
  "created_at": "2024-03-15T10:30:45-08:00",\
  "first_name": "Sarah",\
  "updated_at": "2024-11-20T14:22:10-08:00",\
  "customer_id": 7234567890123,\
  "total_spent": "425.50",\
  "orders_count": 5,\
  "default_address": {\
    "zip": "10001",\
    "city": "New York",\
    "country": "United States",\
    "address1": "123 Broadway Ave",\
    "province": "New York"\
  },\
  "last_order_name": "#9456789",\
  "customer_graphql_api_id": "gid://shopify/Customer/7234567890123"\
}]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer by Email with basic information

Searches for a Shopify customer using their email address and returns their profile information including order history.

This integration searches your Shopify ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Searches for a Shopify customer using their email address and returns their profile information including order history.

* * *

###### Parameters

- **email** ( _String (email)_): Customer email address to search for. Example: “sarah.johnson@example.com”.

* * *

###### Output

Example Output:

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer by First Name, Last Name and Address 1

Searches for Shopify customers using their first name, last name, and street address to find matching customer records.

This integration searches your Shopify s... [Read More](https://kodif.ai/blog/tool/shopify/#)

Searches for Shopify customers using their first name, last name, and street address to find matching customer records.

This integration searches your Shopify store for customers that match a specific combination of first name, last name, and street address. It’s useful when you need to find customer records based on physical address information, especially when you have multiple customers with similar names but different addresses.

* * *

###### Parameters

- **first\_name** ( _String_): Customer’s first name to search for. Example: “Sarah”
- **last\_name** ( _String_): Customer’s last name to search for. Example: “Johnson”
- **address1** ( _String_): Primary street address line to match against customer records. Example: “1425 Oak Street”

* * *

###### Output

Returns an array of customer objects that match the search criteria. Each customer record includes **customer\_id**, **customer\_graphql\_api\_id**, **email**, **first\_name**, **last\_name**, **phone**, **default\_address** (with address1, city, province, country, zip), **orders\_count**, **total\_spent**, **last\_order\_name**, **created\_at**, and **updated\_at**. If no customers are found, returns “no customer info found”.

Example Output:

```
[\
  {\
    "customer_id": 9234567890123,\
    "customer_graphql_api_id": "gid://shopify/Customer/9234567890123",\
    "email": "sarah.johnson@example.com",\
    "first_name": "Sarah",\
    "last_name": "Johnson",\
    "phone": "+15551234567",\
    "default_address": {\
      "address1": "1425 Oak Street",\
      "city": "Dallas",\
      "province": "Texas",\
      "country": "United States",\
      "zip": "75201"\
    },\
    "orders_count": 3,\
    "total_spent": "245.67",\
    "last_order_name": "#9876543",\
    "created_at": "2024-06-15T14:30:22-05:00",\
    "updated_at": "2024-11-20T09:15:33-06:00"\
  }\
]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer by ID

Retrieves a complete Shopify customer profile using their unique customer ID.

This integration fetches detailed information about a specific Shopify customer wh... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves a complete Shopify customer profile using their unique customer ID.

This integration fetches detailed information about a specific Shopify customer when you provide their unique customer ID. It returns the customer’s complete profile including personal information, contact details, purchase history, addresses, marketing preferences, and account tags. This is useful when you need to access comprehensive customer data for support cases, account management, or order assistance.

* * *

###### Parameters

- **customer\_id** ( _String_): The unique Shopify customer ID number. Example: “8124567584853”.

* * *

###### Output

Returns a complete Shopify customer object containing **id**, **email**, **first\_name**, **last\_name**, **phone**, **tags**, **total\_spent**, **orders\_count**, **last\_order\_id**, **last\_order\_name**, **default\_address**, **addresses** array, **created\_at**, **updated\_at**, **verified\_email**, **tax\_exempt**, **currency**, **state**, and marketing consent preferences including **sms\_marketing\_consent** and **email\_marketing\_consent**.

Example Output:

```
{
  "customer": {
    "id": 8124567584853,
    "email": "sarah.johnson@example.com",
    "first_name": "Sarah",
    "last_name": "Johnson",
    "phone": "+15551234567",
    "tags": "Active Subscriber, VIP Customer, Purchaser, Standard",
    "state": "enabled",
    "currency": "USD",
    "total_spent": "742.98",
    "orders_count": 7,
    "last_order_id": 6421209579605,
    "last_order_name": "BB-2651571",
    "created_at": "2025-09-17T21:59:28-07:00",
    "updated_at": "2026-01-31T07:27:07-08:00",
    "tax_exempt": false,
    "verified_email": true,
    "default_address": {
      "id": 9454452080725,
      "name": "Sarah Johnson",
      "address1": "1234 Main Street",
      "address2": null,
      "city": "Portland",
      "province": "Oregon",
      "zip": "97201",
      "country": "United States",
      "phone": "+15551234567",
      "country_code": "US",
      "province_code": "OR"
    },
    "sms_marketing_consent": {
      "state": "subscribed",
      "opt_in_level": "confirmed_opt_in"
    },
    "email_marketing_consent": {
      "state": "subscribed",
      "opt_in_level": "confirmed_opt_in"
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer Orders by Email

Retrieves a customer’s order history from Shopify and returns the two most recent orders for quick order lookup.

This integration searches Shopify for all... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves a customer’s order history from Shopify and returns the two most recent orders for quick order lookup.

This integration searches Shopify for all orders placed by a specific customer email address, then automatically sorts them by date and returns the two most recent orders. This allows support teams to quickly see a customer’s latest purchase activity, order status, and fulfillment details without manually searching through all historical orders.

* * *

###### Parameters

- **email** ( _String (email)_): Customer email address to search for orders. Example: “sarah.johnson@example.com”.
- **status** ( _String_): Order status filter – set to “any” to retrieve orders regardless of their current status (open, closed, cancelled). Example: “any”.

* * *

###### Output

Returns an array containing up to 2 order objects (the most recent first), or a message “no orders found for the customer” if none exist. Each order includes comprehensive details like **id**, **name** (order number), **email**, **total\_price**, **financial\_status**, **fulfillment\_status**, **created\_at**, **line\_items** (products purchased), **shipping\_address**, **billing\_address**, **discount\_codes**, and **fulfillments** with tracking information.

Example Output:

```
[\
  {\
    "id": 6482589843541,\
    "name": "#BB-2752854",\
    "email": "sarah.johnson@example.com",\
    "total_price": "61.00",\
    "financial_status": "paid",\
    "fulfillment_status": null,\
    "created_at": "2026-03-15T02:05:22-07:00",\
    "line_items": [\
      {\
        "id": 15264514310229,\
        "name": "Organic Baby Formula Starter Bundle - Trial - 2",\
        "price": "56.00",\
        "quantity": 1,\
        "sku": "110502000202"\
      }\
    ],\
    "shipping_address": {\
      "name": "Sarah Johnson",\
      "address1": "456 Maple Street",\
      "city": "Portland",\
      "province": "Oregon",\
      "zip": "97201",\
      "country": "United States"\
    },\
    "discount_codes": []\
  }\
]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Customer Orders by Email with basic information

Retrieves all Shopify orders for a customer email address with payment status, fulfillment details, and shipping tracking information.

This integration searches... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves all Shopify orders for a customer email address with payment status, fulfillment details, and shipping tracking information.

This integration searches Shopify for all orders associated with a customer’s email address and returns a comprehensive order history. It’s perfect for customer support teams who need to quickly view a customer’s complete purchase history, check payment status, track shipments, and access order details without logging into Shopify’s admin panel.

* * *

###### Parameters

- **email** ( _String (email)_): The customer’s email address to search for orders. Example: “maria.rodriguez@example.com”.

* * *

###### Output

Returns an array of order objects, each containing essential order information including **order\_id**, **name** (order display name like #1234), **order\_number**, **created\_at** (order date in YYYY-MM-DD format), **total\_price**, **financial\_status** (paid/pending/refunded), **fulfillment\_status** (fulfilled/partial/unfulfilled), **order\_status\_url** (customer order tracking page), and **fulfillments** object containing detailed shipping information including tracking numbers, carrier details, delivery status, and tracking URLs when available.

Example Output:

```
[\
  {\
    "order_id": 7234567890123,\
    "name": "#ABC-US-SX-18945671",\
    "created_at": "2026-03-15",\
    "fulfillment_status": "fulfilled",\
    "financial_status": "paid",\
    "order_number": 18945671,\
    "order_status_url": "https://mystore.myshopify.com/orders/authenticate?key=def456ghi789",\
    "total_price": "24.99",\
    "fulfillments": {\
      "tracking_company": "usps flats",\
      "tracking_number": "9361289012345678901234",\
      "tracking_url": "https://tracking.mystore.com/track/9361289012345678901234",\
      "tracking_numbers": ["9361289012345678901234"],\
      "tracking_urls": ["https://tracking.mystore.com/track/9361289012345678901234"],\
      "fulfillment_status": "success",\
      "shipment_status": "delivered",\
      "fulfillment_created_at": "2026-03-16T09:15:30-08:00"\
    }\
  },\
  {\
    "order_id": 7198765432109,\
    "name": "#1456789",\
    "created_at": "2026-02-28",\
    "fulfillment_status": null,\
    "financial_status": "paid",\
    "order_number": 1456789,\
    "order_status_url": "https://shop.example.com/orders/authenticate?key=abc123xyz456",\
    "total_price": "67.50",\
    "fulfillments": "No fulfillments"\
  }\
]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Discount Code by Code

Gets a discount code by the code provided.

##### Shopify - Get Fulfillment of the Order by Its Order ID

Retrieves Fulfillment of the Order By Its Order ID using Shopify. Requires order\_id and shopify\_prefix. Returns the requested data record(s) with all available details.

##### Shopify - Get Fulfillment Status of the Order by Its Name

Retrieves Fulfillment Status of the Order By Its Name using Shopify. Requires order\_name. Returns the requested data record(s) with all available details.

##### Shopify - Get Full Product Information by ID

Retrieves comprehensive product details from Shopify including variants, inventory levels, pricing, and product images.

This integration fetches complete produc... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves comprehensive product details from Shopify including variants, inventory levels, pricing, and product images.

This integration fetches complete product information from your Shopify store using a product ID. It provides detailed product data including all available variants, inventory quantities, pricing information, product images, vendor details, and availability status. This is useful when you need to access full product specifications, check stock levels across variants, or display comprehensive product information in your support tools.

* * *

###### Parameters

- **product\_id** ( _String (numeric)_): The unique Shopify product ID number used to retrieve the product information. Example: “8529473162845”.

* * *

###### Output

Returns a comprehensive product object containing **product\_id**, **title**, **handle**, **status**, **vendor**, **total\_inventory**, **has\_only\_default\_variant**, **has\_out\_of\_stock\_variants**, **onlineStorePreviewUrl**, plus arrays of **variants** (with variant\_id, title, price, available\_for\_sale, inventory\_quantity, selected\_options) and **images** (with product\_image\_id, url, alt\_text, width, height).

Example Output:

```
{
  "product_id": "8529473162845",
  "title": "Wireless Gaming Headset",
  "handle": "wireless-gaming-headset-pro",
  "status": "ACTIVE",
  "vendor": "TechGear Solutions",
  "total_inventory": 47,
  "has_only_default_variant": false,
  "has_out_of_stock_variants": true,
  "onlineStorePreviewUrl": "https://mystore.myshopify.com/products/wireless-gaming-headset-pro",
  "variants": [\
    {\
      "variant_id": "42863951873024",\
      "title": "Black / USB",\
      "price": "129.99",\
      "available_for_sale": true,\
      "inventory_quantity": 15,\
      "selected_options": [\
        {"name": "Color", "value": "Black"},\
        {"name": "Connection type", "value": "USB"}\
      ]\
    },\
    {\
      "variant_id": "42863951905792",\
      "title": "White / Bluetooth",\
      "price": "149.99",\
      "available_for_sale": false,\
      "inventory_quantity": 0,\
      "selected_options": [\
        {"name": "Color", "value": "White"},\
        {"name": "Connection type", "value": "Bluetooth"}\
      ]\
    }\
  ],
  "images": [\
    {\
      "product_image_id": "gid://shopify/ProductImage/35924267184197",\
      "url": "https://cdn.shopify.com/s/files/1/0123/4567/8901/files/headset-black.jpg",\
      "alt_text": "Wireless Gaming Headset in Black",\
      "width": 1200,\
      "height": 1200\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Open Orders

Shopify Retrieves Open Orders using Shopify. No inputs are required. Returns results based on the executed action.

##### Shopify - Get Order by Confirmation Number

Retrieves a Shopify order by searching with its unique confirmation number to access order details, customer info, and line items.

This integration searches you... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves a Shopify order by searching with its unique confirmation number to access order details, customer info, and line items.

This integration searches your Shopify store for an order using its confirmation number, allowing you to quickly access complete order information including customer details, order status, line items, pricing, and fulfillment status. This is useful when customers reference their confirmation number in support inquiries.

* * *

###### Parameters

- **order\_confirmation\_number** ( _String_): The unique confirmation number associated with the Shopify order. This is typically an alphanumeric code provided to customers after purchase. Example: “XYZ123ABC”.

* * *

###### Output

Returns a structured order object containing the **order\_name** (order number) and comprehensive **order\_details** including customer email, creation date, line items with SKUs and quantities, pricing information, cancellation status, and fulfillment status. If no order is found, returns a message indicating no data was found.

Example Output:

```
{
  "order": {
    "order_name": "1001234567",
    "order_details": {
      "email": "sarah.johnson@example.com",
      "closed": false,
      "createdAt": "2024-01-15T10:30:45Z",
      "lineItems": {
        "edges": [\
          {\
            "node": {\
              "sku": "PROD-4567",\
              "name": "Premium Wireless Headphones",\
              "quantity": 2\
            }\
          }\
        ]
      },
      "cancelledAt": null,
      "cancelReason": null,
      "totalPriceSet": {
        "shopMoney": {
          "amount": "159.98",
          "currencyCode": "USD"
        }
      },
      "order_graphql_id": "gid://shopify/Order/1234567890123",
      "confirmationNumber": "ABC123XYZ",
      "displayFulfillmentStatus": "FULFILLED"
    }
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order by Name

Retrieves a Shopify order by its order name, returning the latest two matching orders.

This integration searches for Shopify orders using the order name (typica... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves a Shopify order by its order name, returning the latest two matching orders.

This integration searches for Shopify orders using the order name (typically the order number with or without a # prefix). When a customer provides their order number, this tool finds the complete order record with all relevant details including items, pricing, shipping, and fulfillment information. The results are sorted by creation date with the most recent orders returned first, limited to the two latest matches.

* * *

###### Parameters

- **order\_name** ( _String_): The order name or number to search for. Can include or exclude the # prefix. Example: “1234567” or “#1234567”.

* * *

###### Output

Returns a list of up to two matching orders (or fewer if only one exists). Each order contains comprehensive details including **id**, **name**, **email**, **total\_price**, **financial\_status**, **fulfillment\_status**, **created\_at**, **line\_items** (with product names, SKUs, quantities, and prices), **shipping\_address**, **billing\_address**, **customer** information, and **fulfillments** (including tracking numbers and shipment status).

Example Output:

```
[\
  {\
    "id": 7476780400712,\
    "name": "#1234567",\
    "email": "sarah.johnson@example.com",\
    "total_price": "124.99",\
    "financial_status": "paid",\
    "fulfillment_status": "fulfilled",\
    "created_at": "2024-03-15T10:30:45-08:00",\
    "line_items": [\
      {\
        "id": 18483498090568,\
        "name": "Classic Cotton T-Shirt - Large",\
        "sku": "TCT4000NAVYL",\
        "quantity": 2,\
        "price": "29.99"\
      }\
    ],\
    "customer": {\
      "first_name": "Sarah",\
      "last_name": "Johnson",\
      "email": "sarah.johnson@example.com"\
    },\
    "shipping_address": {\
      "address1": "456 Oak Street",\
      "city": "Portland",\
      "province": "Oregon",\
      "zip": "97201",\
      "country": "United States"\
    },\
    "fulfillments": [\
      {\
        "tracking_number": "1Z999AA1012345675",\
        "tracking_company": "UPS"\
      }\
    ]\
  }\
]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order by Name with basic information

Retrieves a complete Shopify order record using the order’s display name or number.

This integration searches your Shopify store for orders that match a s... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves a complete Shopify order record using the order’s display name or number.

This integration searches your Shopify store for orders that match a specific order name (like “#1234” or just “1234”). It returns comprehensive order details including customer information, products purchased, pricing, shipping details, fulfillment tracking, and refund history. The search includes all order statuses by default, so you can find cancelled or closed orders as well as active ones.

* * *

###### Parameters

- **name\_of\_the\_order** ( _String_): The order name or number to search for. Can include or exclude the “#” prefix. Example: “9373620” or “#9373620”.

* * *

###### Output

Returns an **orders** array containing matching order objects (typically one result). Each order includes comprehensive details: **order\_id**, **name**, **order\_number**, **email**, **total\_price**, **financial\_status**, **fulfillment\_status**, **created\_at**, **line\_items** (products with SKUs, quantities, prices), **shipping\_address**, **billing\_address**, **fulfillments** (with tracking numbers and URLs), **shipping\_lines** (shipping method and costs), **refunds**, **discounts\_applied**, and **promo\_codes\_applied**.

Example Output:

```
{
  "orders": [\
    {\
      "order_id": 7484458336328,\
      "name": "#9373620",\
      "order_number": 9373620,\
      "email": "sarah.mitchell@example.com",\
      "total_price": "58.53",\
      "currency": "USD",\
      "financial_status": "paid",\
      "fulfillment_status": "partial",\
      "created_at": "2024-03-08T07:39:10-07:00",\
      "line_items": [\
        {\
          "line_item_id": 18500231757896,\
          "name": "Light Gray Stretch Oxford Long Sleeve Button Up Shirt - S",\
          "sku": "TCT4236LGRYS",\
          "price": "24.99",\
          "quantity": 1,\
          "current_quantity": 1,\
          "product_id": 6766109622344\
        }\
      ],\
      "shipping_address": {\
        "first_name": "Sarah",\
        "last_name": "Mitchell",\
        "address1": "742 Oak Street",\
        "city": "Portland",\
        "province": "Oregon",\
        "zip": "97205",\
        "country": "United States",\
        "phone": "5031234567"\
      },\
      "fulfillments": [\
        {\
          "status": "success",\
          "tracking_company": "USPS",\
          "tracking_numbers": ["9261290140407415487497"],\
          "tracking_urls": ["https://tools.usps.com/go/TrackConfirmAction?qtc_tLabels1=9261290140407415487497"],\
          "created_at": "2024-03-10T09:22:50-07:00"\
        }\
      ],\
      "tags": "nofraud_pass, rivo-cashback-opt-in"\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order Financial Details

Retrieves detailed financial breakdown and pricing information for a specific Shopify order including taxes, discounts, and line items.

This integration fetches... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves detailed financial breakdown and pricing information for a specific Shopify order including taxes, discounts, and line items.

This integration fetches comprehensive financial details for a Shopify order, providing a complete breakdown of pricing, taxes, discounts, shipping costs, and individual line item details. It’s perfect for analyzing order profitability, understanding tax calculations, reviewing applied discounts, and getting detailed financial reporting on specific transactions.

* * *

###### Parameters

- **admin\_graphql\_api\_id** ( _String_): The Admin GraphQL API global ID of the order in Shopify’s format. Example: “gid://shopify/Order/1234567890”.

* * *

###### Output

Returns a comprehensive financial breakdown including **totals** (subtotal, total price, taxes, shipping), **order\_name**, **currency\_code**, **created\_at**, **tax\_configuration**, **discount\_codes** and **discount\_applications**, detailed **line\_items** with individual pricing and taxes, **shipping\_lines** with costs, and comprehensive **tax\_lines** for both order-level and line-item-level tax calculations.

Example Output:

```
{
  "admin_graphql_api_id": "gid://shopify/Order/2847593012345",
  "order_name": "#ABC-987654",
  "currency_code": "USD",
  "created_at": "2024-01-15T14:30:22Z",
  "tax_configuration": {
    "tax_exempt": false,
    "taxes_included": false
  },
  "totals": {
    "subtotal_price": "89.99",
    "current_subtotal_price": "89.99",
    "total_price": "98.54",
    "current_total_price": "98.54",
    "total_tax": "8.55",
    "current_total_tax": "8.55",
    "total_shipping_price": "0.0",
    "current_shipping_price": "0.0"
  },
  "discount_codes": ["SAVE15NOW"],
  "discount_applications": [\
    {\
      "allocation_method": "ACROSS",\
      "target_selection": "ENTITLED",\
      "target_type": "LINE_ITEM",\
      "value_type": "PricingPercentageValue",\
      "percentage": 15.0,\
      "amount": null\
    }\
  ],
  "line_items": [\
    {\
      "line_item_id": "gid://shopify/LineItem/9876543210123",\
      "title": "Premium Wireless Headphones",\
      "quantity": 1,\
      "unit_price": "105.87",\
      "discounted_total": "89.99",\
      "tax_lines": [\
        {\
          "title": "CA STATE TAX - CALIFORNIA",\
          "rate": 0.0725,\
          "amount": "6.52"\
        },\
        {\
          "title": "CA COUNTY TAX - LOS ANGELES",\
          "rate": 0.025,\
          "amount": "2.25"\
        }\
      ]\
    }\
  ],
  "shipping_lines": [\
    {\
      "shipping_line_id": "gid://shopify/ShippingLine/1122334455667",\
      "code": "free-shipping",\
      "original_price": "0.0",\
      "discounted_price": "0.0",\
      "tax_lines": []\
    }\
  ],
  "order_tax_lines": [\
    {\
      "title": "CA STATE TAX - CALIFORNIA",\
      "rate": 0.0725,\
      "amount": "6.52"\
    },\
    {\
      "title": "CA COUNTY TAX - LOS ANGELES",\
      "rate": 0.025,\
      "amount": "2.25"\
    }\
  ],
  "current_order_tax_lines": [\
    {\
      "title": "CA STATE TAX - CALIFORNIA",\
      "rate": 0.0725,\
      "amount": "6.52"\
    },\
    {\
      "title": "CA COUNTY TAX - LOS ANGELES",\
      "rate": 0.025,\
      "amount": "2.25"\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order Return Status

Retrieves the return status for a specific Shopify order using its Admin GraphQL API ID.

This integration looks up a specific order in your Shopify store and re... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves the return status for a specific Shopify order using its Admin GraphQL API ID.

This integration looks up a specific order in your Shopify store and returns its current return status. This helps customer service teams quickly determine whether an order has any returns associated with it, such as pending returns, completed returns, or no returns at all. It’s particularly useful for handling customer inquiries about order returns and refunds.

* * *

###### Parameters

- **admin\_graphql\_api\_id** ( _String_): The unique Shopify Admin GraphQL API identifier for the order. This ID follows the format “gid://shopify/Order/\[order\_number\]”. Example: “gid://shopify/Order/8234567890”.

* * *

###### Output

Returns order information including the **order\_id** (the same GraphQL ID you provided), **name** (the order number without the # prefix), and **return\_status** (the current return status for this order).

Example Output:

```
{
  "order_id": "gid://shopify/Order/8234567890",
  "name": "10098765",
  "return_status": "NO_RETURN"
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order Transactions

Retrieves payment transaction details for a Shopify order and identifies which transactions can be refunded.

This integration looks up all payment transactions ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves payment transaction details for a Shopify order and identifies which transactions can be refunded.

This integration looks up all payment transactions associated with a specific Shopify order using the order name/number. It analyzes each transaction to determine refund eligibility and provides the transaction details needed to process refunds. The tool automatically filters out orders that have already been refunded and only returns transactions that are eligible for refunding (successful sales or captures).

* * *

###### Parameters

- **order\_name** ( _String_): The order number or name to look up transactions for. Include the # symbol if it’s part of your order numbering system. Example: “#1582654”.

* * *

###### Output

Returns an orders array containing refund-eligible transaction details. Each order includes the **order\_id\_to\_refund** (Shopify’s internal order ID) and **refundable\_transactions** array with transaction details including **transation\_id**, **gateway\_of\_refund** (payment processor), **kind** (transaction type), **status**, **transaction\_parent\_id** (if applicable), and **maximumRefundableV2** (refund limits). If no refundable transactions exist or the order was already refunded, returns an appropriate message instead.

Example Output:

```
{
  "orders": [\
    {\
      "order_id_to_refund": "gid://shopify/Order/7894561230987",\
      "refundable_transactions": [\
        {\
          "kind": "SALE",\
          "status": "SUCCESS",\
          "transation_id": "gid://shopify/OrderTransaction/9876543210123",\
          "gateway_of_refund": "shopify_payments",\
          "maximumRefundableV2": null,\
          "transaction_parent_id": null\
        }\
      ]\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Order Variant ID

Retrieves product variant IDs from a Shopify order by searching with the order name or number.

This integration searches Shopify for a specific order using its ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves product variant IDs from a Shopify order by searching with the order name or number.

This integration searches Shopify for a specific order using its name or number, then extracts the product variant IDs for each item in that order. This is useful when you need to identify the exact product variants that were purchased, which can be essential for inventory management, reordering, or product analysis.

* * *

###### Parameters

- **order\_name** ( _String_): The exact order name or number used to locate the Shopify order. This can include the hash symbol or be just the numeric portion. Example: “#1234567” or “1234567”.

* * *

###### Output

Returns an object containing the **order\_id** (Shopify’s global ID for the order) and a **products** array with details for each line item. Each product entry includes the **product\_title**, **variant\_title** (which may show pricing for services or “Default Title” for single-variant products), and **shopify\_variantID** (the global variant identifier).

Example Output:

```
{
  "order_id": "gid://shopify/Order/6243857492841",
  "products": [\
    {\
      "product_title": "Water Filter Cartridge",\
      "variant_title": "Default Title",\
      "shopify_variantID": "gid://shopify/ProductVariant/8429563847"\
    },\
    {\
      "product_title": "Shipping Protection by Route",\
      "variant_title": "$2.25",\
      "shopify_variantID": "gid://shopify/ProductVariant/43856291847529"\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Orders by Customer ID

Retrieves all orders placed by a specific Shopify customer using their customer ID.

This integration fetches the complete order history for a specific customer ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves all orders placed by a specific Shopify customer using their customer ID.

This integration fetches the complete order history for a specific customer from your Shopify store. It’s particularly useful for customer service teams who need to quickly see a customer’s purchase history, payment status, shipping details, and tracking information all in one place.

* * *

###### Parameters

- **customer\_id** ( _String_): The unique Shopify customer ID number. Example: “7705668812896”.

* * *

###### Output

Returns an array of order objects for the specified customer. Each order includes **order\_id**, **order\_number**, **order\_name** (display format like “#1582639”), **email**, **currency**, **financial\_status** (paid/pending/refunded), **fulfillment\_status** (fulfilled/partial/unfulfilled), **total\_price**, **created\_at** (order date), and shipping details including **tracking\_company**, **tracking\_number**, **tracking\_url**, and **shipment\_status** when available.

Example Output:

```
[\
  {\
    "email": "jane.mitchell@example.com",\
    "currency": "USD",\
    "order_id": 6333608722528,\
    "created_at": "2026-03-15T00:56:26-07:00",\
    "order_name": "#1582639",\
    "total_price": "54.49",\
    "order_number": 1582639,\
    "tracking_url": "https://track.example.com/#/trackingid/ABC123DEF456",\
    "tracking_number": "ABC123DEF456",\
    "financial_status": "paid",\
    "tracking_company": "other",\
    "fulfillment_status": "success",\
    "shipment_status": "delivered",\
    "fulfillments_created_at": "2026-01-17T09:01:19-08:00",\
    "fulfillments_updated_at": "2026-01-21T09:47:55-08:00"\
  }\
]
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

[See an example](https://kodif.ai/blog/tool/shopify/#)

1. Ask the customer for their email
2. Use @Shopify – Get Customer by Email to retrieve the Customer details
3. If the customer is found, Use the customer\_id and @Shopify – Get Orders by Customer Id to get their orders
4. Display the Order numbers and the items in the order as a bulleted list to the customer

##### Shopify - Get Orders by Phone with basic information

Retrieves recent Shopify orders for a customer using their phone number.

This integration searches Shopify for a customer that matches the phone number you prov... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves recent Shopify orders for a customer using their phone number.

This integration searches Shopify for a customer that matches the phone number you provide and returns their recent order history (up to 5 most recent orders). This allows your team to quickly view a customer’s purchase history, order details, and line items without needing to manually search through the Shopify admin.

* * *

###### Parameters

- **customer\_phone** ( _String_): Customer’s phone number in international format. Example: “+1-555-123-4567”.

* * *

###### Output

Returns an orders array containing up to 5 recent orders for the customer. Each order includes **order\_id**, **name** (order number), **created\_at**, **total\_price**, **currency**, **financial\_status**, **fulfillment\_status**, **email**, **tags**, and a **line\_items** array with product details including name, quantity, price, and SKU. Additional fields include shipping/billing addresses, fulfillment tracking, refunds, and applied discounts when available.

Example Output:

```
{
  "orders": [\
    {\
      "order_id": "gid://shopify/Order/7849203847392",\
      "name": "#892456",\
      "created_at": "2024-03-16T20:02:38Z",\
      "total_price": "247.89",\
      "currency": "USD",\
      "financial_status": "paid",\
      "fulfillment_status": "fulfilled",\
      "email": "sarah.johnson@example.com",\
      "tags": "VIP Customer, First Purchase",\
      "line_items": [\
        {\
          "line_item_id": "gid://shopify/LineItem/18394857362847",\
          "name": "Summer Floral Dress in Blue - Medium",\
          "quantity": 1,\
          "price": "129.00",\
          "sku": "SFD-BLUE-M"\
        },\
        {\
          "line_item_id": "gid://shopify/LineItem/18394857395615",\
          "name": "Matching Belt - Blue",\
          "quantity": 1,\
          "price": "45.00",\
          "sku": "BELT-BLUE"\
        }\
      ],\
      "shipping_address": {\
        "first_name": "Sarah",\
        "last_name": "Johnson",\
        "address1": "789 Oak Street",\
        "city": "Portland",\
        "province": "OR",\
        "country": "US",\
        "zip": "97205"\
      }\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Product by ID

Retrieves detailed information for a specific Shopify product using its unique product ID.

This integration fetches complete product details from your Shopify s... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves detailed information for a specific Shopify product using its unique product ID.

This integration fetches complete product details from your Shopify store when you provide a product ID. It’s useful for customer service teams who need to quickly access product information like available sizes, pricing, SKUs, and product tags to help customers with orders, exchanges, or product inquiries.

* * *

###### Parameters

- **product\_id** ( _String_): The unique Shopify product ID number. Example: “7892341056789”.

* * *

###### Output

Returns a structured product object containing the product’s **id**, **title**, **tags** (as an array), and **variants** array with each variant’s id, title, price, and SKU. Tags help identify product categories, sizing options, collections, and other product attributes. Variants represent different options like sizes or colors with their specific pricing and inventory codes.

Example Output:

```
{
  "id": 7892341056789,
  "title": "Gray Short Sleeve Regular Polo",
  "tags": ["25-45", "XL", "L", "2XL", "Casual Polo", "Short Sleeve", "Regular Fit", "Cotton Blend", "Discount_Eligible", "Online_Store_SKU"],
  "variants": [\
    {\
      "id": 41234567890123,\
      "title": "S",\
      "price": "29.99",\
      "sku": "POL4501GRAYS"\
    },\
    {\
      "id": 41234567890124,\
      "title": "M",\
      "price": "29.99",\
      "sku": "POL4501GRAYM"\
    },\
    {\
      "id": 41234567890125,\
      "title": "L",\
      "price": "29.99",\
      "sku": "POL4501GRAYL"\
    },\
    {\
      "id": 41234567890126,\
      "title": "XL",\
      "price": "29.99",\
      "sku": "POL4501GRAYXL"\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Product Images

Retrieves product images from Shopify using a product ID to display visual content for customer support or order management.

This integration fetches product im... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves product images from Shopify using a product ID to display visual content for customer support or order management.

This integration fetches product images from your Shopify store using a specific product ID. It’s useful when you need to quickly view or display product photos during customer support conversations, order reviews, or inventory management. The tool returns the product’s media images with URLs that can be displayed directly in your workflow.

* * *

###### Parameters

- **all\_product\_id\_to\_image\_search** ( _String_): The unique Shopify product ID to retrieve images for. This should be the numeric product ID from Shopify. Example: “8786436030705”.

* * *

###### Output

Returns product information including the **product\_id**, **title**, and an array of **media** objects. Each media object contains a **media\_id**, **alt** text description, and the **url** where the image is hosted. The tool also provides **final\_html** for easy display of the images.

Example Output:

```
{
  "products": [\
    {\
      "product_id": "gid://shopify/Product/8786436030705",\
      "title": "Premium Wireless Headphones",\
      "media": [\
        {\
          "media_id": "gid://shopify/MediaImage/35616403194097",\
          "alt": "Premium wireless headphones in black",\
          "url": "https://cdn.shopify.com/s/files/1/0668/1116/6961/files/headphones.png?v=1744225410"\
        }\
      ]\
    }\
  ],
  "final_html": "
```

Premium Wireless Headphones

” }

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Product Variants by Product ID

Fetches all variants related to a specific product using the product ID on Shopify.

##### Shopify - Get Refund Transaction Info by Order ID

Retrieves refund transaction details from a Shopify order to prepare for processing a refund.

This integration looks up transaction information for a specific S... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves refund transaction details from a Shopify order to prepare for processing a refund.

This integration looks up transaction information for a specific Shopify order to identify the payment gateway and transaction ID needed to process a refund. It finds the original successful payment transaction and returns the key details required to initiate a refund through the appropriate payment processor.

* * *

###### Parameters

- **order\_id** ( _String_): The Shopify order ID number to look up transaction information for. Example: “7181744701495”.

* * *

###### Output

Returns refund transaction preparation data including the **parent\_id** (original transaction ID), **kind** (always “refund”), and **gateway** (payment processor used). If no successful transaction is found, returns an error message indicating the refund process should be escalated.

Example Output:

```
{
  "refund_transaction": {
    "parent_id": 9195918295095,
    "kind": "refund",
    "gateway": "shopify_payments"
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Shipped Orders

Shopify Retrieves Shipped Orders using Shopify. No inputs are required. Returns results based on the executed action.

##### Shopify - Get Store Catalog

Retrieves all active products and their variants from your Shopify store inventory for easy browsing and management.

This integration pulls your complete Shopif... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves all active products and their variants from your Shopify store inventory for easy browsing and management.

This integration pulls your complete Shopify product catalog, including all active products with their pricing, variants, and SKU information. It automatically filters out any variants with zero pricing to show only sellable items, giving you a clean view of your available inventory.

* * *

###### Parameters

This tool requires no input parameters – it automatically retrieves your entire active product catalog.

* * *

###### Output

Returns a comprehensive product catalog with **total** (number of products), **total\_variants** (total sellable variants), and a **products** array. Each product includes **id**, **title**, and **variants** array with variant details including **id**, **title**, **price**, and **sku**.

Example Output:

```
{
  "total": 3,
  "total_variants": 8,
  "products": [\
    {\
      "id": 7856152445012,\
      "title": "Premium Memory Foam Pillow",\
      "variants": [\
        {\
          "id": 42782044749908,\
          "title": "Standard",\
          "price": 89.99,\
          "sku": "PILLOW-STD-001"\
        },\
        {\
          "id": 42782044782676,\
          "title": "King",\
          "price": 109.99,\
          "sku": "PILLOW-KING-001"\
        }\
      ]\
    },\
    {\
      "id": 6857690054740,\
      "title": "Organic Cotton Sheet Set",\
      "variants": [\
        {\
          "id": 40173552795732,\
          "title": "Twin / White",\
          "price": 126.00,\
          "sku": "SHEETS-TW-WHT"\
        },\
        {\
          "id": 40173552894036,\
          "title": "Queen / Silver",\
          "price": 149.33,\
          "sku": "SHEETS-QN-SLV"\
        }\
      ]\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Unfulfilled Orders

Shopify Retrieves Unfulfilled Orders using Shopify. No inputs are required. Returns results based on the executed action.

##### Shopify - Get Unique Use Promo Code Details

Retrieves unique use promo code details using the code provided by the user, returning whether the code is available or not. If the code was used more than once, it will return ... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves unique use promo code details using the code provided by the user, returning whether the code is available or not. If the code was used more than once, it will return as used (invalid).

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Get Unshipped Orders

Shopify Retrieves Unshipped Orders using Shopify. No inputs are required. Returns results based on the executed action.

##### Shopify - Inactivate Discount Code by Code ID

Inactivates a discount code in Shopify.

##### Shopify - Refund Order Shipping by Order ID

Processes a full refund for shipping costs on a Shopify order when delivery issues occur.

This integration creates a shipping refund for a specific Shopify orde... [Read More](https://kodif.ai/blog/tool/shopify/#)

Processes a full refund for shipping costs on a Shopify order when delivery issues occur.

This integration creates a shipping refund for a specific Shopify order, automatically refunding the full shipping amount back to the customer’s original payment method. It’s commonly used when there are delivery delays, shipping errors, or customer service issues that warrant refunding the shipping cost while keeping the product purchase intact.

* * *

###### Parameters

- **order\_id** ( _String_): The unique Shopify order identifier to refund shipping for. Example: “5847392001”.
- **parent\_id** ( _String_): The transaction ID of the original payment that will be refunded. Example: “8932147650”.
- **gateway** ( _String_): The payment gateway used for the original transaction (typically “shopify\_payments” for Shopify Payments). Example: “shopify\_payments”.

* * *

###### Output

Returns a confirmation message indicating the shipping refund was successfully processed. The refund will be sent back to the customer’s original payment method and they will receive an automatic notification about the shipping refund.

Example Output:

```
"Shipping successfully refunded"
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Retrieve a Specific Order by ID

Retrieves complete order details from Shopify using a specific order ID.

This integration fetches a complete Shopify order record when you provide the order ID,... [Read More](https://kodif.ai/blog/tool/shopify/#)

Retrieves complete order details from Shopify using a specific order ID.

This integration fetches a complete Shopify order record when you provide the order ID, giving you access to all order information including customer details, line items, pricing, shipping addresses, payment status, and fulfillment information. Perfect for customer service teams who need to quickly pull up order details or for systems that need to sync order data.

* * *

###### Parameters

- **order\_id** ( _String_): The unique Shopify order ID to retrieve. Example: “8472650891472”.
- **fields** ( _String (optional)_): Comma-separated list of specific fields to return instead of the full order object. If omitted, returns all order fields. Example: “id,name,email,total\_price”.

* * *

###### Output

Returns a complete Shopify order object containing comprehensive order information including **id**, **name** (order number), **email**, **total\_price**, **financial\_status**, **fulfillment\_status**, detailed **customer** information, **line\_items** (products ordered), **shipping\_address**, **billing\_address**, **tax\_lines**, and **shipping\_lines**. Each line item includes product details like name, price, quantity, SKU, and variant information.

Example Output:

```
{
  "order": {
    "id": 8472650891472,
    "name": "#ABC-US-TX-18593742",
    "email": "sarah.johnson@example.com",
    "total_price": "24.85",
    "financial_status": "paid",
    "fulfillment_status": null,
    "customer": {
      "id": 7234567890123,
      "first_name": "Sarah",
      "last_name": "Johnson",
      "email": "sarah.johnson@example.com",
      "phone": null,
      "default_address": {
        "address1": "456 Oak Avenue",
        "city": "Austin",
        "province": "Texas",
        "zip": "78701",
        "country": "United States"
      }
    },
    "line_items": [\
      {\
        "id": 16745829037264,\
        "name": "Premium Razor Handle - Silver",\
        "price": "12.99",\
        "quantity": 1,\
        "sku": "PRH-001-SIL",\
        "variant_title": "Silver"\
      }\
    ],
    "shipping_address": {
      "first_name": "Sarah",
      "last_name": "Johnson",
      "address1": "456 Oak Avenue",
      "city": "Austin",
      "province": "Texas",
      "zip": "78701",
      "country": "United States"
    },
    "subtotal_price": "23.49",
    "total_tax": "1.36",
    "created_at": "2026-03-15T14:28:33-05:00"
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Send Customer Password Recovery Email

Send Customer Password Recovery Email using Shopify. Requires customer\_email. Returns results based on the executed action.

##### Shopify - Update Customer Address

Updates an existing address for a Shopify customer with new address information.

This integration modifies an existing address in a customer’s Shopify pro... [Read More](https://kodif.ai/blog/tool/shopify/#)

Updates an existing address for a Shopify customer with new address information.

This integration modifies an existing address in a customer’s Shopify profile. You can update any combination of address fields including street address, apartment/unit number, city, state/province, and ZIP code. This is useful when customers move or need to correct address information for shipping and billing purposes.

* * *

###### Parameters

- **customer\_id** ( _String_): The unique Shopify customer identifier. Example: “6867782762532”.
- **address\_id** ( _String_): The unique identifier for the specific address to update. Example: “8185669779492”.
- **address\_line\_1** ( _String_): Primary street address. Example: “425 Oak Street”.
- **address\_line\_2** ( _String, optional_): Secondary address information like apartment or suite number. Example: “Unit 3B”.
- **city** ( _String_): City name. Example: “Portland”.
- **province** ( _String_): State or province name. Example: “Oregon”.
- **zip** ( _String_): ZIP or postal code. Example: “97205”.

* * *

###### Output

Returns the complete updated customer address record containing **id**, **customer\_id**, **name**, **first\_name**, **last\_name**, **phone**, **company**, **address1**, **address2**, **city**, **province**, **zip**, **country**, **country\_code**, **province\_code**, and **default** status. If the address already exists with identical information, returns an error message instead.

Example Output:

```
{
  "customer_address": {
    "id": 8185669779492,
    "customer_id": 6867782762532,
    "name": "Sarah Johnson",
    "first_name": "Sarah",
    "last_name": "Johnson",
    "phone": "+15035551234",
    "company": null,
    "address1": "425 Oak Street",
    "address2": "Unit 3B",
    "city": "Portland",
    "province": "Oregon",
    "zip": "97205",
    "country": "United States",
    "country_code": "US",
    "country_name": "United States",
    "province_code": "OR",
    "default": true
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Update Order Note

Updates Order Note using Shopify. Requires order\_id and order\_note. Returns the updated record with the applied changes.

##### Shopify - Update Order's Address

Updates the shipping address for an existing Shopify order with new customer address information.

This integration modifies the shipping address on a Shopify or... [Read More](https://kodif.ai/blog/tool/shopify/#)

Updates the shipping address for an existing Shopify order with new customer address information.

This integration modifies the shipping address on a Shopify order, allowing you to change where an order will be delivered. It updates the customer’s name, contact information, and complete address details including street address, city, state/province, postal code, and country information.

* * *

###### Parameters

- **order\_id** ( _String_): The unique identifier of the order to update. Example: “6483958759460”.
- **customer\_first\_name** ( _String_): Customer’s first name. Example: “Sarah”.
- **customer\_last\_name** ( _String_): Customer’s last name. Example: “Mitchell”.
- **customer\_full\_name** ( _String_): Customer’s complete name. Example: “Sarah Mitchell”.
- **customer\_phone** ( _String_): Customer’s phone number including country code. Example: “+1-555-123-4567”.
- **customer\_company** ( _String_): Company name (optional, set to null if not applicable). Example: “Tech Solutions LLC”.
- **customer\_address1** ( _String_): Primary street address. Example: “1425 Oak Street”.
- **customer\_address2** ( _String_): Secondary address line (optional). Example: “Suite 200”.
- **customer\_city** ( _String_): City name. Example: “Portland”.
- **customer\_province** ( _String_): Full state or province name. Example: “Oregon”.
- **customer\_province\_code** ( _String_): Two-letter state/province code. Example: “OR”.
- **customer\_country** ( _String_): Full country name. Example: “United States”.
- **customer\_country\_code** ( _String_): Two-letter country code. Example: “US”.
- **customer\_zip** ( _String_): Postal or ZIP code. Example: “97209”.

* * *

###### Output

Returns the complete updated Shopify order object with the new shipping address information. The response includes the updated **shipping\_address** object with all the new address fields, along with order details like **id**, **name**, **customer** information, **line\_items**, pricing, taxes, fulfillment status, and shipping information.

Example Output:

```
{
  "order": {
    "id": 6483958759460,
    "name": "#7118548",
    "email": "sarah.mitchell@example.com",
    "phone": "+1-555-123-4567",
    "customer": {
      "id": 7333262131236,
      "email": "sarah.mitchell@example.com",
      "first_name": "Sarah",
      "last_name": "Mitchell"
    },
    "shipping_address": {
      "zip": "97209",
      "city": "Portland",
      "name": "Sarah Mitchell",
      "phone": "+1-555-123-4567",
      "company": null,
      "country": "United States",
      "address1": "1425 Oak Street",
      "address2": "Suite 200",
      "province": "Oregon",
      "last_name": "Mitchell",
      "first_name": "Sarah",
      "country_code": "US",
      "province_code": "OR"
    },
    "total_price": "49.85",
    "financial_status": "paid",
    "fulfillment_status": "fulfilled"
  }
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify - Update Order's Address with basic information

Updates a Shopify order’s shipping address with new customer contact information and delivery location.

This integration modifies the shipping address for... [Read More](https://kodif.ai/blog/tool/shopify/#)

Updates a Shopify order’s shipping address with new customer contact information and delivery location.

This integration modifies the shipping address for an existing Shopify order. Use this when customers need to change where their order should be delivered – whether it’s a move, incorrect address, or shipping to a different location. The tool updates all shipping address fields including name, phone, company, street address, city, state/province, country, and postal code.

* * *

###### Parameters

- **order\_id** ( _String_): The unique identifier of the Shopify order to update. Example: “6547981598798”.
- **customer\_first\_name** ( _String_): First name for the shipping address. Example: “Sarah”.
- **customer\_last\_name** ( _String_): Last name for the shipping address. Example: “Johnson”.
- **customer\_full\_name** ( _String_): Complete name for the shipping address. Example: “Sarah Johnson”.
- **customer\_phone** ( _String_): Phone number for delivery contact. Example: “+1-555-123-4567”.
- **customer\_company** ( _String_): Company name if shipping to a business (optional). Example: “Acme Corp”.
- **customer\_address1** ( _String_): Primary street address line. Example: “123 Main Street”.
- **customer\_address2** ( _String_): Secondary address line like apartment or suite (optional). Example: “Apt 4B”.
- **customer\_city** ( _String_): City name. Example: “Los Angeles”.
- **customer\_province** ( _String_): State or province name. Example: “California”.
- **customer\_province\_code** ( _String_): State/province code. Example: “CA”.
- **customer\_country** ( _String_): Country name. Example: “United States”.
- **customer\_country\_code** ( _String_): Two-letter country code. Example: “US”.
- **customer\_zip** ( _String_): Postal or ZIP code. Example: “90210”.

* * *

###### Output

Returns the complete updated order object with the new shipping address applied. Key fields include **order\_id**, **order\_name**, **total\_price**, **currency**, **financial\_status**, updated **shipping\_address** with all new address components, **customer** details, **line\_items** (products ordered), **billing\_address**, **discount\_codes**, and **shipping\_lines**.

Example Output:

```
{
  "order_id": 7894561230987,
  "order_name": "#890123",
  "total_price": "156.89",
  "currency": "USD",
  "financial_status": "paid",
  "confirmation_number": "X9K2MNPQR",
  "cancelled_at": null,
  "cancel_reason": null,
  "customer": {
    "customer_id": 8765432109876,
    "first_name": "Emma",
    "last_name": "Rodriguez",
    "email": "emma.rodriguez@example.com",
    "phone": "+1-415-555-0198",
    "state": "enabled",
    "default_address": {
      "address_id": 9988776655443,
      "address1": "789 Pine Street",
      "city": "San Francisco",
      "province": "California",
      "country": "United States",
      "zip": "94102"
    }
  },
  "shipping_address": {
    "address1": "456 Oak Boulevard",
    "city": "Sacramento",
    "province": "California",
    "country": "United States",
    "zip": "95814"
  },
  "billing_address": {
    "address1": "789 Pine Street",
    "city": "San Francisco",
    "province": "California",
    "country": "United States",
    "zip": "94102"
  },
  "line_items": [\
    {\
      "line_item_id": 16789012345678,\
      "product_id": 8901234567890,\
      "variant_id": 45678901234567,\
      "sku": "DRESS-BLU-M",\
      "name": "Summer Dress in Ocean Blue - Medium",\
      "quantity": 1,\
      "price": "89.99"\
    }\
  ],
  "discount_codes": [\
    {\
      "code": "SUMMER20",\
      "type": "percentage",\
      "amount": "18.00"\
    }\
  ],
  "shipping_lines": [\
    {\
      "shipping_line_id": 6677889900112,\
      "title": "Express Shipping",\
      "price": "12.95",\
      "code": "EXPRESS"\
    }\
  ]
}
```

[Read Less](https://kodif.ai/blog/tool/shopify/#)

##### Shopify – Search Customer Addresses

Searches for a customer addresses in Shopify using an email address. Requires customer\_email (required). Returns all the addresses that the customer had

## Integration Configuration

### Getting API Credentials

For information on getting the appropriate Integration credentials, visit the
[Shopify site directly.](https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/generate-app-access-tokens-admin)

The scopes required by KODIF will depend on the specific actions. These are the most commonly required scopes, but more or fewer may be required depending on the actions to be automated.

- read\_assigned\_fulfillment\_orders
- read\_customers
- read\_order\_edits
- read\_order\_edits
- read\_orders
- read\_product\_listings
- read\_products
- read\_returns
- read\_shipping
- write\_assigned\_fulfillment\_orders
- write\_customers
- write\_order\_edits
- write\_order\_edits
- write\_orders
- write\_returns
- write\_shipping

Kodif Chat Widget
