# Connect to an Integration

> Part of the NocoDB documentation (Product docs > Integrations). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/product/integrations/create-connection
Last updated: 2026-09-25

Learn how to create a new connection in NocoDB.

Users with Workspace Owner or Workspace Creator roles can create a new connection in NocoDB. To create a new connection, follow the steps below:

1. Click **Integrations** in the workspace sidebar.
2. From the catalogue, click on the integration you want to connect to
3. In the subsequent modal, provide required details. Please refer to the integration-specific documentation for more details.
   * [PostgreSQL](#postgresql)
   * [MySQL](#mysql)

<img alt="Integrations" src={__img0} placeholder="blur" />

Alternatively, open **Manage** and click **Add connection**, then pick the integration from the dropdown.

<img alt="Add connection" src={__img1} placeholder="blur" />

Connection to an integration thus created will be listed on the **All connections** page.

## Database Integrations

### PostgreSQL

Creating a PostgreSQL connection in NocoDB requires the following details.

<img alt="PostgreSQL Connection" src={__img2} placeholder="blur" />

1. **Connection Name**: Name for this connection for display on NocoDB UI
2. Key in following database connection configuration details
   * **Host Address**: Hostname of the PostgreSQL server
   * **Port Number**: Port number of the PostgreSQL server, default is 5432
   * **Username**: Username to connect to the PostgreSQL server, default is "postgres"
   * **Password**: Password to connect to the PostgreSQL server
   * \[Optional] **Database**: Name of the PostgreSQL database to connect to
   * \[Optional] **Schema Name**: Name of the schema to connect to
     :::info
     Note, Database name & Schema name are optional fields when creating a connection. If provided, these details will be filled in by default when creating a new data source using this connection.
     :::
3. **Connection parameters**: required if any, can be added as Key-Value pairs
4. **SSL Mode**: This step is required if the connection required is TLS/MTLS for MITM protection. Toggle to enable SSL for the connection & select the SSL mode
   * **Client Certificate**: Upload the client certificate file
   * **Client Key**: Upload the client key file
   * **Root CA**: Upload the Root CA file
5. **Test Database Connection**: Click to verify the connection
6. **Create Connection**: Click to save the data source

The connection thus created will be listed on the **All connections** page.

<Callout type="info">
  You can autofill the connection details if you have a connection URL.

    <img alt="Connection URL" src={__img3} placeholder="blur" />
</Callout>

<Callout type="info">
  The entire connection parameters can be viewed in JSON form by clicking on the **Advanced Options** and edited as required by database server type.

  **Example**: When SSL mode set to "Required-Identity," if the server certificate's common name (cname) differs from the actual DNS/IP used for connection, the connection will fail. To resolve, add "servername" property with same cname value under the SSL section. Additional details are available at [knex configuration options](https://knexjs.org/guide/#configuration-options).
</Callout>

### MySQL

Creating a MySQL connection in NocoDB requires the following details.

<img alt="MySQL Connection" src={__img4} placeholder="blur" />

1. **Connection Name**: Name for this connection for display on NocoDB UI
2. Key in following database connection configuration details
   * **Host Address**: Hostname of the MySQL server
   * **Port Number**: Port number of the MySQL server, default is 3306
   * **Username**: Username to connect to the MySQL server, default is "root"
   * **Password**: Password to connect to the MySQL server
   * \[Optional] **Database**: Name of the MySQL database to connect to

<Callout type="info">
  Database name is optional when creating a connection. If provided, it will be filled in by default when creating a new data source using this connection
</Callout>

3. **Connection parameters**: required if any, can be added as Key-Value pairs
4. **SSL Mode**: This step is required if the connection required is TLS/MTLS for MITM protection. Toggle to enable SSL for the connection & select the SSL mode
   * **Client Certificate**: Upload the client certificate file
   * **Client Key**: Upload the client key file
   * **Root CA**: Upload the Root CA file
5. **Test Database Connection**: Click to verify the connection
6. **Create Connection**: Click to save the data source

The connection thus created will be listed on the **All connections** page.

<Callout type="info">
  You can autofill the connection details if you have a connection URL.

    <img alt="Connection URL" src={__img5} placeholder="blur" />
</Callout>

<Callout type="info">
  The entire connection parameters can be viewed in JSON form by clicking on the **Advanced Options** and edited as required by database server type.

  **Example**: When SSL mode set to "Required-Identity," if the server certificate's common name (cname) differs from the actual DNS/IP used for connection, the connection will fail. To resolve, add "servername" property with same cname value under the SSL section. Additional details are available at [knex configuration options](https://knexjs.org/guide/#configuration-options).
</Callout>

## Communication Integrations

### Twilio

Creating a Twilio integration in NocoDB requires the following details.

1. **Integration Name:**
   Enter a name for this integration as it should appear in the NocoDB UI

2. **Authentication Type:**
   Select **API credentials** as the authentication method.

3. **Account SID:**
   Enter your Twilio **Account SID**.
   This can be obtained from the [Twilio Console](https://console.twilio.com/) under **Account Info**.

4. **Auth Token**
   Enter your Twilio **Auth Token**, available in the [Twilio Console](https://console.twilio.com/) under **Account Info**.
   Ensure this value is stored securely.

5. **Test Connection**
   Click **Test connection** to verify that the provided credentials are valid and that NocoDB can connect to Twilio.

6. **Create Integration**
   Click **Create integration** to save the connection.

<img alt="Twilio Integration" src={__img6} placeholder="blur" />

<img alt="Twilio Integration" src={__img7} placeholder="blur" />

Once created, the Twilio integration will be listed on the **All connections** page and can be used across eligible features that support Twilio.

<Callout type="info">
  For trial Twilio accounts, messaging and calls are limited to verified phone numbers, as enforced by Twilio.
</Callout>

**References**

* [Twilio Console](https://console.twilio.com/)
* [Twilio Documentation](https://www.twilio.com/docs/)

## Availability

* Note that, there is no ownership concept for connections in NocoDB. All the connections created in a workspace are accessible to all eligible users in that workspace.
* Users with **Workspace Creator+** permissions can create, edit, duplicate, and delete connections
* Users with **Base Creator+** permissions can create data sources using database connections

---

## Related pages

- [Actions on Connection](https://nocodb.com/docs/product/integrations/actions-on-connection.md): Learn how to perform actions (edit, duplicate, delete) on a connection in NocoDB.