# Using the First Resonance ION Component

The `First Resonance ION` component requires you to configure 2 settings:

1. Connection
2. GraphQL Query

There is also an optional third setting, GraphQL Variables, that can be used to pass variables to the query.

## Connection

Upon the first usage of the `First Resonance ION` component in a flow, you will need to configure the connection.

Click on the `+ Add Connection` button:

<figure><img src="/files/KtuwOzgyWOLXP2BX7kC2" alt=""><figcaption></figcaption></figure>

Enter in a name for the connection and select the Auth Endpoint (environment):

<figure><img src="/files/BcIENi0oCNlM8gRaWpcQ" alt=""><figcaption></figcaption></figure>

Scroll down on the window and enter in the Client ID and Client Secret. Refer to this [page](/api/api-keys.md) on how to retrieve a client id and secret then click on the Sign in button.

<figure><img src="/files/N9cpuBfQ2zhzsKgIpwr3" alt=""><figcaption></figcaption></figure>

In subsequent usages of the `First Resonance ION` component within the flow, you will be able to select the connection from the dropdown.

<figure><img src="/files/ePjFy0BwQOzooS5mJE34" alt=""><figcaption></figcaption></figure>

## GraphQL Query

Click on the E`dit` link to enter in a valid GraphQL query/mutation.

<figure><img src="/files/rh8PmZWnVJREAEnlr1XW" alt=""><figcaption></figcaption></figure>

### Example Query

Here is an example GraphQL query to get issues and their related part inventories:

<figure><img src="/files/HHsQ4jBui5av7a2B2hqI" alt=""><figcaption></figcaption></figure>

See [below](#example-query-1) for the example query variables.

### Example Mutation

Here is an example GraphQL mutation to update an issue:

<figure><img src="/files/YZm0VRulsNIdPmtb7gZI" alt=""><figcaption></figcaption></figure>

See [below](#example-mutation-1) for the example query variables.

## GraphQL Variables

Click on the `Edit` link to enter any GraphQL variables that your query/mutation requires.

<figure><img src="/files/NtQWBFTlfs3XfbaDjluR" alt=""><figcaption></figcaption></figure>

### Example Variables

Here is how to setup the variables for the query:

Click on the hamburger icon to the left of the `Edit` link to expose the sub-menu then select `Reference`.

<figure><img src="/files/RjWVeg6CeD9tZvbbCvSq" alt=""><figcaption></figcaption></figure>

Enter the following json into the field:

```json
{
  "filters": {
    "id": {"eq": }
  }
}
```

Place the cursor after the `"eq":` then click the button to the right of the field.

<figure><img src="/files/hM5Mul0kiyqBnmBwKBdX" alt=""><figcaption></figcaption></figure>

Select the reference step and the Reference path. In this example we are dynamically pulling in the id that is passed to the webhook and that id will be used to filter for a specific issue.

<figure><img src="/files/mudls5QW7gBPtDWf4T2C" alt=""><figcaption></figcaption></figure>

Once you have configured the reference the query variables should look like this:

<figure><img src="/files/ePkk5Oc0FEocrR5Us39S" alt=""><figcaption></figcaption></figure>


---

# 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://manual.firstresonance.io/workflow-builder/first-resonance-ion-component/using-the-first-resonance-ion-component.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.
