Header
Introduction
Any key pairs added to the header tab are passed into authentication request headers - for example:
![](https://doc.wearepatchworks.com/~gitbook/image?url=https%3A%2F%2F2440044887-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLYNcUBVQwSkOMG6KjZfz%252Fuploads%252F8FmP79ErOqNVikqCw94U%252Fheader%25201.png%3Falt%3Dmedia%26token%3Db18ace09-b2b6-4dbd-8f5d-371ef315ca02&width=768&dpr=4&quality=100&sign=d0c0e6a8&sv=1)
In this example, we've already defined two auth variables for username and password, so users will be prompted to enter these details when adding an instance of this connector for use in process flows.
How we then pass this information into API requests is determined by the API documentation for the underlying third-party application. Often, these details are passed in request headers, but sometimes it will be via the request body.
By adding these as key pairs to the header, we pass any values provided for these fields in the authentication request headers.
You should refer to the authentication section of your your API documentation for specific guidance about what (if any) values need to be passed in authentication request headers. For example, in Shopify, it's noted that we need to send two values in the request header - Content-Type
and Shopify-Access-Token
:
![](https://doc.wearepatchworks.com/~gitbook/image?url=https%3A%2F%2F2440044887-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLYNcUBVQwSkOMG6KjZfz%252Fuploads%252FTwSpGOxSjAlWfJkPP8qV%252FShopify%2520docs%2520headers.png%3Falt%3Dmedia%26token%3D0aec65fc-7cdc-4e67-8ef3-43280caed801&width=768&dpr=4&quality=100&sign=f0ea3d10&sv=1)
When an authentication method is applied for an endpoint, any header/body parameters specified for the authentication method are also sent in the endpoint requests.
Adding header parameters
Header parameters are added as key pairs. To add a header parameter, follow the steps below:
Step 1: Click the add new header button:
![](https://doc.wearepatchworks.com/~gitbook/image?url=https%3A%2F%2F2440044887-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLYNcUBVQwSkOMG6KjZfz%252Fuploads%252F4vD5Q1Pzev9Adf8xKdlO%252Fheader%25202.png%3Falt%3Dmedia%26token%3Db5e8bf04-e693-4ed8-8bb9-0b907fa3b7f5&width=768&dpr=4&quality=100&sign=9a3225e&sv=1)
Step 2: Complete key pair details as required and save changes:
![](https://doc.wearepatchworks.com/~gitbook/image?url=https%3A%2F%2F2440044887-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FLYNcUBVQwSkOMG6KjZfz%252Fuploads%252FjhwZ3rxIlj5VUkpoYF5F%252Fheader%25203.png%3Falt%3Dmedia%26token%3D62381a32-fdbc-48ab-93a1-182d1537438a&width=768&dpr=4&quality=100&sign=fac65da&sv=1)
The add option page is the same for all types of parameters that you may encounter in the connector builder. For information about these options please see the Working with parameters page.
For guidance on configuring parameters for specific authentication types, please see our Supported authentication types section.
Editing & removing header parameters
Header parameters are standard key pairs - techniques for working with these parameters are the same as those for working with body parameters, URL parameters, etc. For more information about these techniques, please see the Working with parameters page.
Last updated