# "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="/pages/-MjyEEUgJVlgbAA7AODr#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](/formulas/apps.md), or our [=API("options")](/formulas/functions.md) to interact with any application API.
{% endhint %}

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

| Page                                                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p>🚀 <a href="/pages/-MjtZY-40yRn97o3WpS0"><strong>Quick Start</strong></a>​</p><p>60 second getting started guide.</p>                                           |
| <p><strong>​</strong><a href="/pages/-MjtX5XgEZMTHrXWxuJv"><strong>❓ FAQ</strong></a><strong>​</strong></p><p>Answers to frequently asked SheetLink questions.</p> |
| <p>🔗 <a href="/pages/-Mj_8Ab0W3muPFi_CFmV"><strong>Apps</strong></a><strong>​</strong></p><p>Explore the apps we've already built formulas for.</p>               |
| <p>🛠️ <a href="/pages/-MjdlTO1gwme--tVTlRW"><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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sheet.link/formulas/options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
