# Custom APIs & Integrations

{% embed url="<https://youtu.be/3XG9L2MyoEY>" %}

### Introduction

Databar has many different pre-built integrations which you can use without any setup. However, you may also want to use custom APIs for enrichments and exporters, which we don't currently have on our site. Some of the use cases for adding your own APIs are:

**Custom enrichments**

* If we don't have an integration in our [API library ](https://www.databar.ai/explore)but you need it for your workflow
* If you have an internal or private API which you'd like to use for enrichments
* If you'd like to run lookups and workflows with your CRM or internal systems

**Custom exporters**

* If you'd like to send data from Databar to a custom API
* If you'd like to send data from Databar to a custom CRM or internal database
* If you'd like to send data from Databar to a data source or integration which we do not currently have in our [API library](https://www.databar.ai/explore)

### How to add custom APIs

1. Go to your [workspace home](https://www.databar.ai/tables) & click on **Integrations**
2. Click **Connect a custom API**

<figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2F3NaJq4X1R8jWgauXxqJV%2FScreenshot%202024-07-11%20at%205.00.05%E2%80%AFPM.png?alt=media&#x26;token=a545d090-7343-4146-b403-bcccfb41c946" alt=""><figcaption></figcaption></figure>

3. Fill in the APIs details in the form<br>

   <figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2F9M2gl5FcGua52I9FZgdm%2FScreenshot%202024-07-11%20at%205.01.49%E2%80%AFPM.png?alt=media&#x26;token=46450691-e71b-41c3-9670-6ba58bfd69c9" alt=""><figcaption></figcaption></figure>
4. Click **Save**

If you added a custom enrichment, you should see it under the **Add or use your own REST API** button in the **Enrich side-bar**

<figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2FwZbYB5Aco85yHuMkX9on%2FScreenshot%202024-07-11%20at%205.02.46%E2%80%AFPM.png?alt=media&#x26;token=de65ae74-34a4-45bf-ab76-c377a2f49f68" alt=""><figcaption></figcaption></figure>

If you added a custom exporter/data sender, you will see it under the **Send this data to a custom API** button in the **Share** side-bar

<figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2Fow83Ob7UpuXEn6ODMbKr%2FScreenshot%202024-07-11%20at%205.03.55%E2%80%AFPM.png?alt=media&#x26;token=193918f1-9eec-4f02-a7a5-a43778cf9f6a" alt=""><figcaption></figcaption></figure>

5. Set up all of the mapping the same way you would in a regular enrichment/exporter
6. Install the API and click Run!

## Good to know

#### Override Content-type parameters

You can override API-specific text, like content-types by simply adding them as a parameter. For example, if you want to override the 'Content-type' parameter and send

```
"Content-Type":"application/x-www-form-urlencoded"
```

Then simply add it as a parameter and we'll override the value that we send by defualt.

#### Add a custom template for body parameters

To add a custom template for body type parameters, simply click on **Use a custom template** under the Body parameters section and input your JSON.

<figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2FTxEoTGs15nfHd7MMD46Q%2FScreenshot%202024-11-05%20at%202.00.16%E2%80%AFAM.png?alt=media&#x26;token=daff0f91-be3a-4c11-976d-70ff5b838c9b" alt=""><figcaption></figcaption></figure>

After you click on "Use a custom template" you'll see a textbox input. You'll need to input dynamic paramaters according to the API doc you'd like to add. Any dynamic parameters that need to be referenced inside tables need to have $ signs before & after them, as shown below:

<figure><img src="https://536782565-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN1gGey2zqiCs3FbMHdrl%2Fuploads%2F6QPi5Vu7Wm2fn7pf8cMS%2FScreenshot%202025-03-31%20at%206.02.42%E2%80%AFPM.png?alt=media&#x26;token=8e987566-75ec-4e65-aec8-f0ba5e3af89e" alt=""><figcaption></figcaption></figure>

*Please view the video above for a more detailed break-down. If you run into any issues, please send us a message at <info@databar.ai> and we'll be glad to assist you. Availability of custom connectors is subject to your* [*plan details*](https://www.databar.ai/pricing)*.*