> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chamelio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# NetSuite

> Connect NetSuite to Chamelio so Chamelio webhooks are delivered directly to a NetSuite Suitelet.

On request

NetSuite is turned on per organization. If you don't see **NetSuite** in **Settings** > **Org Integrations**, ask your Chamelio legal engineer to turn it on.

The NetSuite integration lets Chamelio send [webhook](https://docs.chamelio.ai/api-reference/webhooks/introduction.md) events straight to NetSuite. Use it when your finance or procurement team wants NetSuite to react to Chamelio events, such as a task completing or a contract being signed, without a middleware service in between.

## How it works

NetSuite receives Chamelio webhooks through a Suitelet that your NetSuite admin deploys. A Suitelet URL looks like this:

```text theme={null}
https://<account>.extforms.netsuite.com/app/site/hosting/scriptlet.nl?script=<script-id>&deploy=<deploy-id>
```

NetSuite only accepts calls that carry its webhook API key and a browser-style user agent. When your organization has connected NetSuite, Chamelio adds both to every webhook it sends to a NetSuite Suitelet URL:

| Header | Value |
| - | - |
| `X-API-KEY` | The NetSuite webhook API key you saved in Chamelio |
| `User-Agent` | A browser-compatible user agent that NetSuite accepts |

Chamelio adds these headers only for Suitelet URLs on `extforms.netsuite.com`. Webhooks sent to any other endpoint don't include the NetSuite API key. Each delivery still includes the standard `X-Chamelio-Signature` header, so your Suitelet can [verify the request](https://docs.chamelio.ai/api-reference/webhooks/introduction.md).

## Prerequisites

* NetSuite turned on for your organization by your Chamelio legal engineer
* A Chamelio account with Admin permission
* A deployed NetSuite Suitelet that receives the webhook, and its webhook API key, from your NetSuite admin

## Connect NetSuite

**1. Open Org Integrations**

In Chamelio, go to **Settings** > **Org Integrations**.

**2. Connect NetSuite**

On the **NetSuite** card, click **Connect**.

**3. Enter the API key**

In **Connect NetSuite**, enter the **Webhook API key** and click **Connect**. Chamelio doesn't show the key again after you save it.

The **NetSuite** card then shows that NetSuite is connected. If the connection fails, Chamelio shows **Couldn't connect to NetSuite**. Check the key with your NetSuite admin and try again.

## Send webhooks to NetSuite

After NetSuite is connected, register the Suitelet URL as a webhook endpoint:

1. Go to **Settings** > **Developer** > **Webhooks**.
2. Add the Suitelet URL as an endpoint.
3. Subscribe it to the events NetSuite needs.

Chamelio then delivers those events directly to NetSuite. See [Webhooks](https://docs.chamelio.ai/api-reference/webhooks/introduction.md) for the available events and payloads.

## Disconnect NetSuite

**1. Open Org Integrations**

Go to **Settings** > **Org Integrations**.

**2. Disconnect**

On the **NetSuite** card, disconnect the integration and confirm **Disconnect NetSuite?** with **Disconnect**.

Chamelio removes the stored API key. Webhooks to your Suitelet URL no longer include it, so NetSuite rejects them until you connect again. To change the key, disconnect and connect again with the new key.