Skip to content

Dubb

The Dubb modules allow you to create, update, delete, and retrieve the contacts in your Dubb account.

Getting Started with Dubb

Prerequisites

  • A Dubb account

In order to use Dubb with Ibexa Connect, it is necessary to have a Dubb account. You can use your Facebook account or create a Dubb account at dubb.com/register.

Note

The module dialog fields that are displayed in bold (in the Ibexa Connect scenario, not in this documentation article) are mandatory!

Connecting Dubb to Ibexa Connect

To connect your Dubb account to Ibexa Connect you need to obtain the API Key from your Dubb account and insert it in the Create a connection dialog in the Ibexa Connect module.

  1. Login to your Dubb account.

  2. Click your Profile Icon > API Token > Create API Token.

    61f26b907f64e.gif

  3. Enter a name for the token and click Create.

    61f26b93633e4.png

  4. Copy the API token to your clipboard.

    61f26b94592f8.png

  5. Go to Ibexa Connect and open the Dubb module's Create a connection dialog.

    61f26b95b79f8.gif

  6. In the Connection name field, enter a name for the connection.

  7. In the API Key field, enter the API token copied in step 4 and click Continue.

The connection has been established.

Actions

Get a Contact

Retrieves a contact.

Contact ID Select the Contact ID whose details you want to retrieve.

Create a Contact

Creates a new contact.

Email address

Enter the email address of the contact.

Full Name

Enter the full name of the contact.

First Name

Enter the first name of the contact.

Last Name

Enter the last name of the contact.

Company

Enter the company name to which the contact belongs to.

Title

Enter the contact's position in the company.

Mobile

Enter the mobile number of the contact.

User ID

Enter the User ID of the contact.

Unsubscribed

Select whether the contact was unsubscribed:

  • Yes

  • No

  • Not defined

Source

Enter the source details of the contact. For example,

Tags

Enter tags to filter the contacts when searching.

Update a Contact

Updates an existing contact by ID.

Contact ID

Select the Contact ID whose details you want to update.

Email address

Enter the email address of the contact.

Full Name

Enter the full name of the contact.

First Name

Enter the first name of the contact.

Last Name

Enter the last name of the contact.

Company

Enter the company name to which the contact belongs to.

Title

Enter the contact's position in the company.

Mobile

Enter the mobile number of the contact.

User ID

Enter the User ID of the contact.

Unsubscribed

Select whether the contact was unsubscribed:

  • Yes

  • No

  • Not defined

Source

Enter the source details of the contact. For example,

Tags

Enter tags to filter the contacts when searching.

Delete a Contact

Deletes an existing contact by ID.

Contact ID Select the Contact ID you want to delete.

Make an API Call

Performs an arbitrary authorized API call.

URL

Enter a path relative to https://api.dubb.com/api. For example: /contact

For the list of available endpoints, refer to the Dubb API Documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use - List Contacts

The following API call returns all the contacts from your Dubb account:

URL:

/contact

Method:

GET

61f26b97c7769.png

Matches of the search can be found in the module's Output under Bundle > Body > data.

In our example, 10 contacts were returned:

61f26b98d31b5.png

Searches

List Contacts

List all contacts.

Limit

Set the number of contacts Ibexa Connect should return during one scenario execution cycle. You can return a maximum of 1000 contacts.

Sort by

Select the order to sort the contacts:

  • ID

  • Full Name

  • First Name

  • Last Name

  • Company

  • Created at

  • Updated at

Direction

Select the direction to the contacts:

  • Asc

  • Desc

Search

Enter a keyword or phrase to search the contacts based on the specified criteria.