> For the complete documentation index, see [llms.txt](https://resmocom.gitbook.io/product/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resmocom.gitbook.io/product/integrations/segment-integration.md).

# Segment Integration

## Resmo + Segment Integration Fundamentals

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

Resmo's agentless integration with Segment allows you to gain visibility, security, and compliance over your resources.

### What does Resmo offer to Segment users?

* Collect directory assets like roles, users, groups, and sources from your Segment account.
* Query your Segment roles, users and sources, and much more.
* Set up security rules based on Segment resource configurations.
* Receive timely notifications of critical rule changes and take faster remediation actions.

### How does the integration work?

Resmo uses an API key created from the Segment Admin page. Our application uses API to make the initial polling and receive existing resources. Then, we receive resource changes and updates in real-time through regular polling.

#### Available resources

{% embed url="<https://resources.resmo.com/segment>" %}

## Integration walkthrough

### How to install

1. Select Segment on the Integrations page of your Resmo account.
2. Click the Add Integration button at the bottom right corner of the opening modal.
3. Open your Segment account on a new tab on your browser.
4. On your Segment workspace, go to Settings -> Workspace Settings -> Access Management -> Tokens and create a new token.

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

5\. Assign Access should be 'Workspace Owner'; unfortunately, there is no read-only option for Segment integration. Don't worry; Resmo only polls your configuration data without any critical information.

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

6\. Go back to the Resmo Segment integration screen, fill in the form with API Key and click Save.

<figure><img src="/files/79zT5UsHrAj7ouTTTICm" alt=""><figcaption></figcaption></figure>

7\. You are now ready! Now you can start querying your Segment resources!

### How to uninstall

1. Go to your Integrations page and click the Segment integration.
2. Open the Connected Integrations tab on the modal and select the account you want to remove.
3. There are two options you can follow. One is to temporarily pause the integration through the **Disable** button from the top right, which can be enabled back later.&#x20;

* The other is to permanently remove it by clicking the **Delete** button, which cannot be undone.&#x20;

<figure><img src="/files/3kiskpSls0C7s5hHwCFF" alt=""><figcaption></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 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://resmocom.gitbook.io/product/integrations/segment-integration.md?ask=<question>&goal=<endgoal>
```

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