API for Developers
API for Developers
Join 20,000+ other marketers and start getting marketing clarity

Subscribe to our newsletter and get proven marketing strategies for growing your business.

    Suggested Blog Articles
    What is Cost Per Lead and Why Should You Care?
    Lead Analytics What is Cost Per Lead and Why Should You Care?

    Last update on Mar 18, 2022

    Simple ValueTrack Setup for Adwords Tracking
    Marketing Simple ValueTrack Setup for Adwords Tracking

    Last update on Jun 4, 2015

    9 of the Best Marketing Dashboard Tools for Agencies
    Marketing 9 of the Best Marketing Dashboard Tools for Agencies

    Last update on May 9, 2022

    Roles

    The roles resource allows you to retrieve user roles.

    Roles Instance Resources

    MethodEndpointDescription
    GET/api/v1/rolesGet a paginated list of details for all roles.
    GET/api/v1/roles/{role_id}Get details about a single role.

    Get All Roles

    Get a paginated list of details for all roles.

    Resource Details

    MethodEndpoint
    GEThttps://app.whatconverts.com/api/v1/roles

    Supported Parameters

    ParameterTypeDescriptionRequired
    roles_per_pagenumberNumber of roles to return for this request (default 25, maximum 250).No
    page_numbernumberPage number to return for this request.No
    orderstringOrder in which to return the roles by name; (default) asc or desc.No
    role_typestringRole type to return for this request; (default) master_account or account user.No

    Response Details

    ParameterTypeDescription
    roles_per_pagenumberThe number of roles returned in the request.
    page_numbernumberThe current page number in the request.
    total_pagesnumberThe total amount of pages available in the request.
    total_rolesnumberThe total amount of roles available in the request.
    rolesarrayContains all the requested roles.
    role_idnumberUnique identifier for the role.
    role_typestringThe type of role. master_account_role or account_role
    role_namestringThe name of the role.

    Example Response

        {
          "page_number": 1,
          "roles_per_page": 25,
          "total_pages": 2,
          "total_roles": 45,
          "roles": [
            {
              "role_id": 42390328,
              "role_type": "master_account_role",
              "role_name": "Administrator"
            },
            ...
          ]
        }
    

    Get Single Role

    Get details for specific role.

    Resource Details

    MethodEndpoint
    GEThttps://app.whatconverts.com/api/v1/roles/{role_id}

    Supported Parameters

    No supported parameters.

    Response Details

    ParameterTypeDescription
    roles_per_pagenumberThe number of roles returned in the request.
    page_numbernumberThe current page number in the request.
    total_pagesnumberThe total amount of pages available in the request.
    total_rolesnumberThe total amount of roles available in the request.
    rolesarrayContains all the requested roles.
    role_idnumberUnique identifier for the role.
    role_typestringThe type of role. master_account_role or account_role
    role_namestringThe name of the role.
    lead_notificationsbooleanIf the role is able to receive lead notifications.
    permissionsobjectPermissions for this role.
    integrationsstringPermissions for integrations. none, view or edit.
    leadsstringPermissions for leads. none, view or edit.
    profilesstringPermissions for profiles. none, view or edit.
    reportsstringPermissions for reports. none, view or edit.
    settingsstringPermissions for settings. none, view or edit.
    trackingstringPermissions for tracking. none, view or edit.
    accountsstringPermissions for accounts. none, view or edit. Applicable to master_account roles.
    billingstringPermissions for billing. none, view or edit. Applicable to master_account roles.
    securitystringPermissions for security. none, view or edit. Applicable to master_account roles.
    usersstringPermissions for users. none, view or edit. Applicable to master_account roles.

    Example Response

        {
          "page_number": 1,
          "roles_per_page": 1,
          "total_pages": 1,
          "total_roles": 1,
          "users": [
            {
              "role_id": 42390328,
              "role_type": "master_account_role",
              "role_name": "Administrator"
              "lead_notifications": true,
              "permissions": {
                "integrations": "edit",
                "leads": "edit",
                "profiles": "edit",
                "reports": "edit",
                "settings": "edit",
                "tracking": "edit",
                "accounts": "edit",
                "billing": "edit",
                "security": "edit",
                "users": "edit"
              }
            }
          ]
        }
    
    Get a FREE presentation of WhatConverts

    One of our marketing experts will give you a full presentation of how WhatConverts can help you grow your business.

    Schedule a Demo
    Whatconverts Features for your Business
    Automated Spam Blocking
    Lead Tracking Automated Spam Blocking

    WhatConverts uses a list of known spammers to eliminate calls, and continually improves spam blocking.

    Search for Leads by Name
    Lead Management Search for Leads by Name

    WhatConverts instantly pulls Caller ID information, so you can quickly search for leads by name.

    Dynamic Phone Number Insertion
    Lead Tracking Dynamic Phone Number Insertion

    Automatically track marketing to a phone call with Dynamic Number Insertion (DNI).

    Export Filtered Leads
    Lead Management Export Filtered Leads

    Easily filter and export leads in real time from your WhatConverts Dashboard.

    Join 20,000+ other marketers and start getting marketing clarity

    Subscribe to our newsletter and get proven marketing strategies for growing your business.

      Suggested Blog Articles
      Client Communication 101: How to Say I've Got This!
      Marketing Client Communication 101: How to Say I've Got This!

      Last update on Oct 9, 2019

      Did You Know – Holiday Call Flows
      Marketing Did You Know – Holiday Call Flows

      Last update on Dec 22, 2023

      Here's Why Clients Love Our Reporting Software for Agencies
      Lead Analytics Here's Why Clients Love Our Reporting Software for Agencies

      Last update on Mar 8, 2021

      ready to get marketing clarity?

      Grow your business with WhatConverts

      14 days free trial Easy setup Dedicated support
      G2 Users Love Us Badge
      G2 High Performer Badge
      G2 High Performer Small Business Badge
      G2 Momentum Leader Badge
      G2 High Performer Europe Badge