> For the complete documentation index, see [llms.txt](https://docs.integry.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.integry.ai/workspaces/user-variables.md).
# User Variables
The user object in Integry is meant to represent your end-users. You can use this object if you need to pass custom user-specific data to a Flow.
#### Defining user variables
By default, the user object has:
* `userID` (Required)
* Used to associate a user's integrations with their account in your app.
* `apiKey` (Optional)
* Can be used to authenticate HTTP calls to your app.
If you need to add additional user variables:
1. Go to Workspace Settings -> Variables.
2. Add the variables under User Variables.
#### Accessing user variables in a flow
You can reference all user variables in flow steps.
1. In the body section of an HTTP Call step, click Add tag -> User Variables. 
2. Select the variable you want to use in the step. The values shown are only to help you map. 
Don't worry about the values shown; they're from your test account and will be replaced with your user's values at run-time.
#### Passing user variables with the SDK
When you [embed the marketplace widget](https://docs.integry.ai/hc/en-us/articles/23189976901529), you pass the variables in the user object.
```
user: {
userId: "asim@integry.io",
apiKey: "453546546754",
}
```
#### Passing additional user variables with the SDK
The additional variables are also passed in the same user object.
```
user: {
userId: "asim@integry.io",
apiKey: "453546546754",
orgId: "12",
region: "North America",
}
```
#### FAQs
**What happens if I pass an empty value for a user variable?**
In order to protect you from accidentally breaking existing integrations (that may be using that user variable's existing value), we don't empty out the value of a user variable when you send an empty string ("").
If you really want to empty it, send a blank space (" ").
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://docs.integry.ai/workspaces/user-variables.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.