1. Home
  2. Voting Board SDK
  3. Add Voters Custom Data Fields via API

Add Voters Custom Data Fields via API

Not all customers are created equal. Sometimes there’s a specific user group you want to focus on. Here are some examples:

  • Paying customers
  • Churned customers
  • Customers who signed up in the last 6 months
  • Users billing cycle

Start to get users metadata to see feedback based on priority user groups (e.g. Paying, Churned, VIP, etc.)

You can pass different users’ data into Ducalis, check this data on Voters’ List, create filters based on this information.

How it Works

User data is fed into Ducalis using any of the following methods:

  1. Widget
  2. Ducalis API (this article tells about it)


Base URL API Ducalis – https://ducalis.io/api/.

Every API request must be sent with an authorization token. There two methods that can be used to send the authorization token:

  1. Query by the token parameter. For example, https://ducalis.io/api/boards?token=XXXXXX.
  2. Authorization header with Bearer xxxxx content For example:
curl --location --request POST 'https://ducalis.io/api/boards' \
--header 'Authorization: Bearer YOUR_TOKEN_HERE' \
--header 'Content-Type: application/json' \
--data-raw '[

The token for authorization of API requests can be obtained here:

Token for API

Pagination and Rate limits

Each request gets a list with a limit of 100 objects by default. The maximum limit is 500 objects. To change the limit, you need to specify the parameter per-page in the request. For example https://ducalis.io/api/boards?per-page=20.

To specify a page, you must use the parameter page. For example, https://ducalis.io/api/boards?page=2.

User Data Management

Users can create posts, votes, and comments. The API allows you to fetch a specific user and get users’ metadata.

Creating/changing a user

Request POST users

Request example:

    "name":"User Name",
        "name":"Company Name",

The User Object

idUser ID
emailUser email
nameUser name
avatarUser avatar
companyCompany object
company.idCompany ID
company.nameCompany name
company.custom_fieldsThe list of custom fields (see Docs)

The response from the server will be empty.

Updating user email

Request PUT users/email/<url_encoded_email>


emailUser Email

Request example:

curl --location --request PUT 'https://ducalis.io/api/users/email/<url_encoded_email>?token=YOUR_TOKEN_HERE' \
--header 'Content-Type: application/json' \
--data-raw '{"email":"user@gmail.com"}'

Removing a User

Request DELETE users/<url_encoded_email>

Request example:

curl --location --request DELETE 'https://ducalis.io/api/users/<url_encoded_email>?token=YOUR_TOKEN_HERE' \
--header 'Content-Type: application/json' 

The response from the server will be empty.

As that data is passed into Ducalis, you can filter feedback using your customers’ metadata.

Next Steps:

  1. Manage users subscriptions via Open API
  2. Manage users subscriptions via .csv
Updated on June 12, 2023

Was this article helpful?

Related Articles

Leave a Comment