# "options"

{% hint style="info" %}
All "options" must be a **cell reference** (B2), a **cell range** (B2:D2), or **comma separated in double quotes** ("option1","option2")
{% endhint %}

### Example 1 (simple)

\=HubSpot\_getContacts("rawHeaders,name=Elon,/name")

### API Request "options"

The below "options" are sent along with the request to your application.

| "options"                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>API</strong> <a href="https://en.wikipedia.org/wiki/Application_programming_interface_key"><strong>Key</strong></a> <strong>(set, reset or query)</strong></p><p><em>"key=reset"</em> <strong>(reset API key)</strong></p><p><em>"key=?"</em> <strong>(query API key)</strong></p><p><strong>\*\*</strong> "key=MY-KEY" <strong>(\*\*careful, key is saved to</strong> <a href="https://support.google.com/docs/answer/190843?hl=en&#x26;co=GENIE.Platform%3DDesktop#zippy=%2Csee-who-changed-a-part-of-a-document-in-google-docs"><strong>sheet history</strong></a><strong>)</strong></p><p><em><strong>The alternative "</strong></em><a href="../../security#api-keys-and-authentication">🔐 <em><strong>Authentication</strong></em></a><em><strong>" method is recommended</strong></em></p> |
| <p><strong>Payload (</strong><a href="https://www.json.org/json-en.html"><strong>JSON</strong></a> <strong>format)</strong></p><p>"{'KEY':'VALUE'}"</p><p><em>"{'pie':{'cook\_time':'20 Min','temp\_degrees':'350'}}"</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <p><strong>Payload (</strong><a href="https://developer.mozilla.org/en-US/docs/Glossary/Base64"><strong>base64</strong></a> <strong>encode)</strong></p><p><em>"{'KEY':'\<encode>VALUE\</encode>'}"</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| <p><strong>cURL (or =cURL formula)</strong></p><p><em>"\<curl>cURL-HERE\</curl>"</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| <p><strong>Headers (</strong><a href="https://www.json.org/json-en.html"><strong>JSON</strong></a> <strong>format)</strong></p><p>"headers={'KEY':'VALUE'}"</p><p><em>"headers={'Accept-Version':'1.0'}"</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><strong>Content Type</strong></p><p><em>"contentType=application/x-www-form-urlencoded"</em></p><p><em>"contentType=application/json"</em> <strong>(default if blank)</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| <p><strong>URL Parameters</strong></p><p>"KEY=VALUE"</p><p><em>"color=blue,email=<hi@sheet.link>"</em></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| <p><strong>Method</strong></p><p>"method=METHOD-HERE"</p><p><em>"method=GET"</em> <strong>(default if no Payload)</strong></p><p><em>"method=POST"</em> <strong>(default if Payload)</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

### API Response "options"

The below "options" are used to format the app's JSON API response.

| "options"                                                                                                                                                                                                                                                                                                                                                                                                      |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Response Headers</strong></p><p><em>"rawHeaders"</em> <strong>(returns raw /QUERY headers)</strong></p><p><em>"/QUERY"</em> <strong>("rawHeaders" to query)</strong></p><p><em>"noHeaders"</em> <strong>(return data without headers)</strong></p>                                                                                                                                                  |
| <p><strong>Response Data</strong></p><p><em>"inheritParents"</em> <strong>(inherit JSON parent elements)</strong></p><p><em>"truncateValues"</em> <strong>(shorten response values)</strong></p><p><em>"debugLocation"</em> <strong>(row & column with values)</strong></p>                                                                                                                                    |
| <p><strong>Raw Response Data</strong> (advanced)</p><p><em>"*"</em> <strong>(return raw JSON response)</strong></p><p><em>"*/QUERY"</em> <strong>(query raw JSON response)</strong></p><p><em>"\*?"</em> <strong>(request options with response)</strong></p><p><em>"$QUERY"</em> <strong>(JSON</strong> <a href="https://github.com/JSONPath-Plus"><strong>Path-Plus</strong></a> <strong>query)</strong></p> |

{% hint style="success" %}
You can try the [SheetLink pre-built app formulas](https://docs.sheet.link/formulas/apps), or our [=API("options")](https://docs.sheet.link/formulas/functions) to interact with any application API.
{% endhint %}

### Navigation <a href="#where-to" id="where-to"></a>

| Page                                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>🚀 <a href="../quickstart"><strong>Quick Start</strong></a>​</p><p>60 second getting started guide.</p>                                    |
| <p><strong>​</strong><a href="../faq"><strong>❓ FAQ</strong></a><strong>​</strong></p><p>Answers to frequently asked SheetLink questions.</p> |
| <p>🔗 <a href="apps"><strong>Apps</strong></a><strong>​</strong></p><p>Explore the apps we've already built formulas for.</p>                 |
| <p>🛠️ <a href="functions"><strong>Functions</strong></a><strong>​</strong></p><p>Powerful functions unique to SheetLink.</p>                 |

## 🚑 Need Help?

You can always contact us via <support@sheet.link> or by messaging us on Twitter [@SheetLink](https://twitter.com/SheetLink)
