Custom Connector

Custom Connector is incredibly powerful as it allows you to build integrations to any public API that Alloy does not natively support. You'll be able to use all of Embedded's features including data mapping, modal customization, and end-user configurability.

Creating a Custom Connector

To start, click "Create a Custom Connector".

Next, input the connector's name and logo. You can change this later on. In this example, we'll be setting up a custom connector using Spotify's APIs. To proceed, click the continue button.

Authentication in Custom Connector

You'll be prompted to input the authentication details for the app you're connecting to.

To authenticate with your chosen API, you can choose between OAuth 2.0, Basic, Bearer, API Key, or None. Your selection will dictate how Alloy authenticates with your chosen API and the fields presented to your end-users during their authentication experience.

To proceed with setting up your custom connector, You will need a valid credential with the app you're looking to authenticate with. The credentials inputted for any method you select will be saved to your account and are required in workflow building.

At the bottom of the form, you can configure refresh parameters if the token refresh URL differs from the authentication URL.

API Definitions

Once your credential is added, you will have the option to add a Base URL for the connector's API. This makes it easier to manage the actions you create within Alloy later down the line.

Once set, you can make a test request to ensure the configuration works as expected.

Passing Variables in a Request URL

When using Custom Connector with Custom Action, you can pass variables in the request URL. Learn more.


Alloy's Custom Connector also allows you query GraphQL APIs using the GraphQL query builder. Learn more.