> For the complete documentation index, see [llms.txt](https://help.realviewhub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.realviewhub.com/settings/api-management.md).

# API Management

## &#x20;<a href="#h_6f0fd2714a" id="h_6f0fd2714a"></a>

### Introduction <a href="#h_1261ef5d90" id="h_1261ef5d90"></a>

This guide outlines the process for generating and testing API keys within the Realview Hub platform. API keys are essential for programmatic access to your data, enabling external integrations and custom applications to interact securely with your Realview Hub account.

### Prerequisites <a href="#h_a31c07f633" id="h_a31c07f633"></a>

* Access to the Realview Hub web application.
* Permissions to manage API settings within your organization's configuration.

### Steps <a href="#h_0b750613f9" id="h_0b750613f9"></a>

### 1. Navigate to API Settings <a href="#h_174622cf05" id="h_174622cf05"></a>

1. From the Realview Hub dashboard, locate and click on Settings in the main navigation menu.
2. In the left-hand sidebar under Settings, scroll down and click on API. This will display the API Configuration page.

### 2. Create a New API Key <a href="#h_0acfed00fc" id="h_0acfed00fc"></a>

1. On the API Configuration page, locate the "API Keys" section.
2. Click the + Create API Key button.
3. A "Create New API Key" dialog box will appear.
   * Name: Enter a descriptive name for your API key (e.g., "Production API Key", "CRM Integration Key").
   * Expires At (optional): To set an expiry date for the key, click the calendar icon and select a date. If left blank, the key will not expire.
4. Click the Create button to generate your new API key. The key will now be listed under the "API Keys" section.

### 3. View API Documentation and Test Endpoints <a href="#h_c06ced4479" id="h_c06ced4479"></a>

1. In the "API Configuration" section, click the View API Docs & Test button.
2. You will be redirected to the interactive API documentation and testing interface.
3. Enter your newly generated API key into the designated field for authentication.
4. Authenticate your API key as prompted.
5. You can now use the interface to test all available API endpoints.

### Tips <a href="#h_b34e2a75d7" id="h_b34e2a75d7"></a>

* Always follow best practices and security guidelines when using and managing your API keys.
* Consider setting an expiry date for API keys that are used for temporary integrations or specific projects to enhance security.
* Name your API keys clearly to easily identify their purpose and associated integrations.

### Conclusion <a href="#h_eb0cd21a80" id="h_eb0cd21a80"></a>

By following these steps, you can successfully create and test API keys in Realview Hub, enabling secure and efficient external integrations with your data.


---

# 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://help.realviewhub.com/settings/api-management.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.
