# The manual for the New ION Experience has been released.

Check it out! [The manual for the New ION Experience has been released.](https://docs.firstresonance.io/)

For the complete documentation index, see [llms.txt](https://manual.firstresonance.io/llms.txt). This page is also available as [Markdown](https://manual.firstresonance.io/workflow-builder/first-resonance-ion-component/using-the-first-resonance-ion-component.md).

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:

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

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

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

## GraphQL Query

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

### Example Query

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

See [below](https://manual.firstresonance.io/workflow-builder/first-resonance-ion-component/using-the-first-resonance-ion-component#example-query-1) for the example query variables.

### Example Mutation

Here is an example GraphQL mutation to update an issue:

See [below](https://manual.firstresonance.io/workflow-builder/first-resonance-ion-component/using-the-first-resonance-ion-component#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.

### 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`.

Enter the following json into the field:

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

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

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.

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