> For the complete documentation index, see [llms.txt](https://glyue.docs.sandboxbanking.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://glyue.docs.sandboxbanking.com/tutorials/building-a-single-step-integration/1.-creating-the-integration.md).

# 1. Creating the Integration

**Create the Integration**

To create an integration, navigate to the **Build Page** using the navigation sidebar along the left, then click the plus icon (+) in the toolbar along the bottom. This will open the **Integration Configuration Wizard**.

In the wizard, give your new integration a name and description. For example:

> **Name:** User Management (Tutorial)\
> \
> **Description:** This integration requests a user from randomuser.com and performs basic processing on it.

<figure><img src="https://688288018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1flQ2To8tQpCQWl2Ty9U%2Fuploads%2FWshCYiyvGEEqg0h8ordP%2FScreenshot%202024-09-03%20at%2011.57.47%E2%80%AFAM.png?alt=media&amp;token=15398f82-550d-494b-8ce9-32a026ca412a" alt=""><figcaption><p>Create a new integration</p></figcaption></figure>

Leave all other fields as they are, click *Save*, then click *Continue*. You will now see the *Systems* step in the wizard.

**Adding a System**

Integration Gateway uses **Adapters** to store information about the third-party systems you're integrating with. We will now add the information for the `randomuser` API.

Click on *Add System,* then search for and select `HTTP` from the *Available Adapters* dropdown list.

<figure><img src="https://688288018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1flQ2To8tQpCQWl2Ty9U%2Fuploads%2FJN6gHu96WHpWUEt2kojU%2FScreenshot%202024-09-03%20at%2011.58.13%E2%80%AFAM.png?alt=media&amp;token=2fd62576-da72-4f41-bbf8-0a91a9a4d4fe" alt=""><figcaption><p>Add a new <code>HTTP</code> adapter</p></figcaption></figure>

Beneath it, click on the *Select Adapter Config* dropdown, then click *Add New Adapter*. This will open a popup window.

In the popup window, enter the following:

* Name: `randomuser API`
* Host: `glyuedev.public.internal.sandboxbanking.com`

Leave all other fields blank / as-is and click *Save Adapter Bindings*, then click *Continue*.

<figure><img src="https://688288018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1flQ2To8tQpCQWl2Ty9U%2Fuploads%2FfihOLEfYq9eqPA9OhlVs%2FScreenshot%202024-09-03%20at%2011.58.57%E2%80%AFAM.png?alt=media&amp;token=05a7cd35-3b9f-4225-aa16-170ba0e3fc53" alt="" width="563"><figcaption><p>Add <code>randomuser</code> API details to the HTTP adapter</p></figcaption></figure>

{% hint style="info" %}
The `randomuser` API doesn't involve authentication so we can leave most of the fields blank. For other APIs that require various forms of authentication, those credentials would be entered here.
{% endhint %}

The final step of the wizard involves sharing permissions to edit and run your integrations with others. For now, we'll skip this step and click on *Go to Build*, where we will see our new integration highlighted on the **Build Page.**

<figure><img src="https://688288018-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1flQ2To8tQpCQWl2Ty9U%2Fuploads%2FXZY6PnwJOgT4jubqzGdT%2FScreenshot%202024-09-03%20at%2011.52.44%E2%80%AFAM.png?alt=media&amp;token=62861d99-2e0d-4fda-994e-42e6c396636e" alt=""><figcaption><p>New integration created</p></figcaption></figure>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://glyue.docs.sandboxbanking.com/tutorials/building-a-single-step-integration/1.-creating-the-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
