Send HTTP request

TheSend HTTP requestaction connects your workflow to a web server or URL and sends HTTP requests.

After Flow sends your HTTP request, it waits for a maximum of 30 seconds for anHTTP response code. If Flow hasn't received a response after 30 seconds, then it closes the connection to your app and it resends the request.

Fields

TheSend HTTP requestaction contains the following fields.

Fields used in the Send HTTP request action.
Field	Description
HTTP method	The method of HTTP request to send. TheSend HTTP requestaction supports the following methods: Get- Sends a request for information from the server. 删除- Removes a resource from the server. Head- Retrieves the HTTP response headers of the server. Options- Retrieves the options and features that are supported by the server. Patch- Partially updates a resource on the server. Put- Updates a resource on the server. Post- Creates or replaces a resource on the server.
URL	The URL of the server to which the HTTP request is sent.
Headers	The key and value pair for the HTTP request. Multiple key-value pairs can be entered.
Body	The content to be sent to the server.

Triggers

TheSend HTTP requestaction can be used in any workflow.

Examples

Call the Shopify GraphQL Admin API

In this example, you will use Flow to edit a product title by calling theproductUpdateAPI.

Before you begin, do the following:

Set up and install a Custom Appthat has thewrite_productsscope. You will use theAPI Secret Keyto call the API in this example.

Then, follow these steps in Flow:

Choose theProduct status updatedtrigger, which allows you to test this workflow by changing the status on a product.
AddSend HTTP Requestto your workflow and connect it to the trigger.
Open the configuration panel by clicking theSend HTTP Requeststep.
In theHTTP Methodfield, enterPOST.
In theURLfield, enterhttps://admin.shopify.com/store/shopname/api/2023-01/graphql.jsonsubstituting your shop domain and desired API Version.
In theHeaderssection, enter aKeyofX-Shopify-Access-TokenandValueofYOUR_API_SECRET_KEYthat you obtained in the first step.
In theHeaderssection, enter a second header withKeyofContent-TypeandValueofapplication/json.
In theBodysection, enter the following:

{"query":"mutation { productUpdate(input: {id:\"{{ product.id }}\", title:\"{{product.title}}-edited\"}) { product { id } } }"}

This code adds-editedto the end of your title
Spaces and newlines are meaningful to the Liquid editor, so avoid adding or removing spaces. Also, except for outputting Liquid, avoid collapsing brackets like{{and}}因为他们是预留给液体variables.

Configure the rest of the workflow and activate it.
Test it by changing the status on a Product fromDrafttoActiveor vice versa.

Call an External API

Example of a workflow that sends a POST HTTP request when an order is paid

In this example workflow, a POST HTTP request is sent to a server when an order is paid.

Response codes

The following table describes how Flow processes theHTTP response codeafter it receives a response.

How Flow processes HTTP response codes.
HTTP response code	How Flow processes the response code
2XX or 3XX Success	Flow marks the HTTP request as a success, and performs subsequent actions in the workflow.
429 or 5XX Error	Flow automatically retries the action for up to 24 hours until it receives a different response code or it times out.
Other response code	If your app returns a code that isn't described in this table or it times out while retrying actions, then Flow marks the HTTP request as failing. Subsequent workflow actions are not taken.