Account

The authenticated user reveals the details of the API caller's user account as well as certain details about the account of which the user is member. The products array reveals all ActiveProspect products and to which the caller's account is subscribed.

Account

Details of the company account

id
required
string (ID) ^[0-9a-fA-F]{24}$

24 character alpha-numeric BSON identifier

sso_id
string (ID) ^[0-9a-fA-F]{24}$

24 character alpha-numeric BSON identifier

api_key
string

Company-level API key (best practice is to use user-level API key)

name
string

Company name

time_zone
string
type
string
data_retention_in_days
integer

Number of days to retain lead events. Events outside the retention period are automatically deleted permanently.

data_truncated_at
string <date-time> (Timestamp)
keen_project_id
string
keen_read_api_key
string
keen_write_api_key
string
pricing_components
Array of objects
billing_type
string
Enum: "contracted" "self_service"
financial_state
string

Only populated when the billing_type is "contracted"

Enum: "paid" "unpaid"
financial_state_updated_at
string <date-time> (Timestamp)
lead_ping_enabled
boolean
product_id
string
state
string
Array of objects

List of connected buyers

Array of objects

List of connected sellers

Array of objects

List of invited pending seller entities

Array of objects

List of invited pending buyer entities

object
object
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "5fd4371e940df5a34a3888b2",
  • "api_key": "string",
  • "name": "Acme, Inc.",
  • "time_zone": "America/New_York",
  • "type": "string",
  • "data_retention_in_days": 0,
  • "data_truncated_at": "2019-08-24T14:15:22Z",
  • "keen_project_id": "string",
  • "keen_read_api_key": "string",
  • "keen_write_api_key": "string",
  • "pricing_components": [
    • { }
    ],
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "pending_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "pending_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "subscriptions": {
    • "base": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "pro": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "partner": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      }
    },
  • "features": {
    • "seller_access": true,
    • "buyer_access": true,
    • "lead_transactions": true,
    • "conversion_feedback": true,
    • "firehose": true,
    • "third_party_add_on_services": true,
    • "real_time_bidding": true,
    • "leadconduit_trustedform_decisions": true
    }
}

User

id
required
string (ID) ^[0-9a-fA-F]{24}$

ID of this user

sso_id
string

The account's ID global across all ActiveProspect products

api_key
string

The user's API key

superuser
boolean

Is the user a super user?

user_admin
boolean

Can the user manage other users and verified domains?

subscription_admin
boolean

Can the user manage subscriptions to TrustedForm, LeadConduit, and SuppressionList?

role_string
string

The user's role (unused)

Value: "user"
first_name
required
string

The user's first name

last_name
required
string

The user's last name

email
required
string

The user's email address

phone
string

The user's phone number

Array of objects (Account)
Array of objects (Product)

The list of products available to the account

object
object
product_code
string

The code for the current product

Enum: Description
lcx

LeadConduit

trustedform

TrustedForm

suppressionlist

SuppressionList

company_name
string
expires
string <date-time> (Timestamp)
Array of objects (UserSubscription)
zendesk_jwt
string
created_at
string <date-time> (Timestamp)
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "6493820b542ea0521e2a4543",
  • "api_key": "2f1d5f29915b866c7a2fa5de29613104",
  • "superuser": false,
  • "user_admin": true,
  • "subscription_admin": true,
  • "role_string": "user",
  • "first_name": "Jane",
  • "last_name": "Doe",
  • "email": "janedoe@company.com",
  • "phone": "512-555-1212",
  • "accounts": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "sso_id": "5fd4371e940df5a34a3888b2",
      • "api_key": "string",
      • "name": "Acme, Inc.",
      • "time_zone": "America/New_York",
      • "type": "string",
      • "data_retention_in_days": 0,
      • "data_truncated_at": "2019-08-24T14:15:22Z",
      • "keen_project_id": "string",
      • "keen_read_api_key": "string",
      • "keen_write_api_key": "string",
      • "pricing_components": [
        • { }
        ],
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "pending_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "pending_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "subscriptions": {
        • "base": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "pro": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "partner": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          }
        },
      • "features": {
        • "seller_access": true,
        • "buyer_access": true,
        • "lead_transactions": true,
        • "conversion_feedback": true,
        • "firehose": true,
        • "third_party_add_on_services": true,
        • "real_time_bidding": true,
        • "leadconduit_trustedform_decisions": true
        }
      }
    ],
  • "products": [],
  • "membership": {
    • "account_id": "5fd4371e940df5a34a3888b2",
    • "lc_access": true,
    • "sl_access": true,
    • "tf_access": true,
    • "product": "string",
    • "product_access": true,
    • "subscription_admin": true,
    • "user_admin": true,
    • "user_id": "5fd4371e940df5a34a3888b2"
    },
  • "permissions": {
    • "lcx": "string",
    • "suppressionlist": "string",
    • "trustedform": "string"
    },
  • "product_code": "lcx",
  • "company_name": "string",
  • "expires": "2019-08-24T14:15:22Z",
  • "subscriptions": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "state": "string",
      • "account_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_id": "string",
      • "product_offering": {
        • "id": "string",
        • "product_id": "string",
        • "component": "string",
        • "name": "string"
        }
      }
    ],
  • "zendesk_jwt": "string",
  • "created_at": "2019-08-24T14:15:22Z"
}

Credential

One of:
id
required
string^[0-9a-fA-F]{24}$

The ID of the credential which uniquely identifies it

name
required
string

Friendly name for this credential

type
required
string

The type of model changes were performed on: user, token, oauth

Value: "user"
package
required
string

The name of the LeadConduit integration package to which this credential belongs

created_at
string <date-time>
updated_at
string <date-time>
username
required
string non-empty

The username to user for basic authentication

password
required
string non-empty

The password to user for basic authentication

property name*
additional property
any
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "username": "string",
  • "password": "string"
}

Get account

Returns the account information of the caller (based on authentication)

SecurityAPIKey
Responses
200

OK

get/account
Request samples 
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "5fd4371e940df5a34a3888b2",
  • "api_key": "string",
  • "name": "Acme, Inc.",
  • "time_zone": "America/New_York",
  • "type": "string",
  • "data_retention_in_days": 0,
  • "data_truncated_at": "2019-08-24T14:15:22Z",
  • "keen_project_id": "string",
  • "keen_read_api_key": "string",
  • "keen_write_api_key": "string",
  • "pricing_components": [
    • { }
    ],
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "pending_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "pending_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "subscriptions": {
    • "base": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "pro": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "partner": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      }
    },
  • "features": {
    • "seller_access": true,
    • "buyer_access": true,
    • "lead_transactions": true,
    • "conversion_feedback": true,
    • "firehose": true,
    • "third_party_add_on_services": true,
    • "real_time_bidding": true,
    • "leadconduit_trustedform_decisions": true
    }
}
Update account
Update my account information


SecurityAPIKey 
Request 
Request Body schema: application/json
required
Update an existing Account


data_retention_in_days
integer
Number of days to retain lead events. Events outside the retention period are automatically deleted permanently.


 
data_truncated_at
string <date-time>  (Timestamp) 
 
object
 
object
 
Responses 
200
OK


put/account
Request samples 
application/json
{
  • "data_retention_in_days": 0,
  • "data_truncated_at": "2019-08-24T14:15:22Z",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "subscriptions": {
    • "base": {
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_component": "partner"
      },
    • "pro": {
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_component": "partner"
      },
    • "partner": {
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_component": "partner"
      }
    },
  • "features": {
    • "seller_access": true,
    • "buyer_access": true,
    • "lead_transactions": true,
    • "conversion_feedback": true,
    • "firehose": true,
    • "third_party_add_on_services": true,
    • "real_time_bidding": true,
    • "leadconduit_trustedform_decisions": true
    }
}
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "5fd4371e940df5a34a3888b2",
  • "api_key": "string",
  • "name": "Acme, Inc.",
  • "time_zone": "America/New_York",
  • "type": "string",
  • "data_retention_in_days": 0,
  • "data_truncated_at": "2019-08-24T14:15:22Z",
  • "keen_project_id": "string",
  • "keen_read_api_key": "string",
  • "keen_write_api_key": "string",
  • "pricing_components": [
    • { }
    ],
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "sso_id": "5fd4371e940df5a34a3888b2"
      }
    ],
  • "pending_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "pending_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string",
      • "expired": true,
      • "invitation_expires_at": "2019-08-24T14:15:22Z"
      }
    ],
  • "subscriptions": {
    • "base": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "pro": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      },
    • "partner": {
      • "id": "5fd4371e940df5a34a3888b2",
      • "state": "active",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "product_offering_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_component": "partner"
      }
    },
  • "features": {
    • "seller_access": true,
    • "buyer_access": true,
    • "lead_transactions": true,
    • "conversion_feedback": true,
    • "firehose": true,
    • "third_party_add_on_services": true,
    • "real_time_bidding": true,
    • "leadconduit_trustedform_decisions": true
    }
}
List all credentials
Get the list of all credentials.


SecurityAPIKey 
Responses 
200
OK


get/credentials
Request samples 
Response samples 
application/json
null
Create a new credential
Create a new credential


SecurityAPIKey 
Request 
Request Body schema: application/json
required
Create a new credential


One of:
name
required
string
Friendly name for this credential


 
type
required
string
The type of model changes were performed on: user, token, oauth


 Value: "user"  
package
required
string
The name of the LeadConduit integration package to which this credential belongs


 
username
required
string  non-empty 
The username to user for basic authentication


 
password
required
string  non-empty 
The password to user for basic authentication


 
property name*
additional property
any
 
Responses 
201
Created


post/credentials
Request samples 
application/json
{
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "username": "string",
  • "password": "string"
}
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "username": "string",
  • "password": "string"
}
Get a credential
Returns the credential matching the specified ID


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
ID of the credential to get


 
 Example:  5fd4371e940df5a34a3888b2
Responses 
200
OK


get/credentials/{id}
Request samples 
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "username": "string",
  • "password": "string"
}
Update a credential
Update an existing credential matching the specified ID


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
ID of the credential to update


 
 Example:  5fd4371e940df5a34a3888b2
Request Body schema: application/json
required
Create a new credential


One of:
name
required
string
Friendly name for this credential


 
type
required
string
The type of model changes were performed on: user, token, oauth


 Value: "user"  
package
required
string
The name of the LeadConduit integration package to which this credential belongs


 
username
required
string  non-empty 
The username to user for basic authentication


 
password
required
string  non-empty 
The password to user for basic authentication


 
property name*
additional property
any
 
Responses 
200
OK


put/credentials/{id}
Request samples 
application/json
{
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "username": "string",
  • "password": "string"
}
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "username": "string",
  • "password": "string"
}
Delete a credential
Deletes the credential matching the specified ID


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
ID of the credential to delete


 
 Example:  5fd4371e940df5a34a3888b2
Responses 
200
OK


delete/credentials/{id}
Request samples 
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "name": "string",
  • "type": "string",
  • "package": "string",
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z",
  • "username": "string",
  • "password": "string"
}
Get user
This singleton resource returns the currently authenticated user


SecurityAPIKey 
Responses 
200
OK


get/user
Request samples 
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "6493820b542ea0521e2a4543",
  • "api_key": "2f1d5f29915b866c7a2fa5de29613104",
  • "superuser": false,
  • "user_admin": true,
  • "subscription_admin": true,
  • "role_string": "user",
  • "first_name": "Jane",
  • "last_name": "Doe",
  • "email": "janedoe@company.com",
  • "phone": "512-555-1212",
  • "accounts": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "sso_id": "5fd4371e940df5a34a3888b2",
      • "api_key": "string",
      • "name": "Acme, Inc.",
      • "time_zone": "America/New_York",
      • "type": "string",
      • "data_retention_in_days": 0,
      • "data_truncated_at": "2019-08-24T14:15:22Z",
      • "keen_project_id": "string",
      • "keen_read_api_key": "string",
      • "keen_write_api_key": "string",
      • "pricing_components": [
        • { }
        ],
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "pending_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "pending_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "subscriptions": {
        • "base": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "pro": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "partner": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          }
        },
      • "features": {
        • "seller_access": true,
        • "buyer_access": true,
        • "lead_transactions": true,
        • "conversion_feedback": true,
        • "firehose": true,
        • "third_party_add_on_services": true,
        • "real_time_bidding": true,
        • "leadconduit_trustedform_decisions": true
        }
      }
    ],
  • "products": [],
  • "membership": {
    • "account_id": "5fd4371e940df5a34a3888b2",
    • "lc_access": true,
    • "sl_access": true,
    • "tf_access": true,
    • "product": "string",
    • "product_access": true,
    • "subscription_admin": true,
    • "user_admin": true,
    • "user_id": "5fd4371e940df5a34a3888b2"
    },
  • "permissions": {
    • "lcx": "string",
    • "suppressionlist": "string",
    • "trustedform": "string"
    },
  • "product_code": "lcx",
  • "company_name": "string",
  • "expires": "2019-08-24T14:15:22Z",
  • "subscriptions": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "state": "string",
      • "account_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_id": "string",
      • "product_offering": {
        • "id": "string",
        • "product_id": "string",
        • "component": "string",
        • "name": "string"
        }
      }
    ],
  • "zendesk_jwt": "string",
  • "created_at": "2019-08-24T14:15:22Z"
}
Update user
Resource for User or user admin to toggle modal flag


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
ID of the user to update


 
 Example:  5fd4371e940df5a34a3888b2
Request Body schema: application/json
required
UI State flags are passed as boolean values. Response will return the flag as a date-time string or null value


object
User interface state


 
Responses 
200
OK


put/user/{id}
Request samples 
application/json
{
  • "ui_state": {
    • "has_seen_free_account_modal": true
    }
}
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "6493820b542ea0521e2a4543",
  • "api_key": "2f1d5f29915b866c7a2fa5de29613104",
  • "superuser": false,
  • "user_admin": true,
  • "subscription_admin": true,
  • "role_string": "user",
  • "first_name": "Jane",
  • "last_name": "Doe",
  • "email": "janedoe@company.com",
  • "phone": "512-555-1212",
  • "accounts": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "sso_id": "5fd4371e940df5a34a3888b2",
      • "api_key": "string",
      • "name": "Acme, Inc.",
      • "time_zone": "America/New_York",
      • "type": "string",
      • "data_retention_in_days": 0,
      • "data_truncated_at": "2019-08-24T14:15:22Z",
      • "keen_project_id": "string",
      • "keen_read_api_key": "string",
      • "keen_write_api_key": "string",
      • "pricing_components": [
        • { }
        ],
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "sso_id": "5fd4371e940df5a34a3888b2"
          }
        ],
      • "pending_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "pending_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string",
          • "expired": true,
          • "invitation_expires_at": "2019-08-24T14:15:22Z"
          }
        ],
      • "subscriptions": {
        • "base": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "pro": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          },
        • "partner": {
          • "id": "5fd4371e940df5a34a3888b2",
          • "state": "active",
          • "created_at": "2019-08-24T14:15:22Z",
          • "updated_at": "2019-08-24T14:15:22Z",
          • "active_at": "2019-08-24T14:15:22Z",
          • "inactive_at": "2019-08-24T14:15:22Z",
          • "product_offering_id": "5fd4371e940df5a34a3888b2",
          • "product_offering_component": "partner"
          }
        },
      • "features": {
        • "seller_access": true,
        • "buyer_access": true,
        • "lead_transactions": true,
        • "conversion_feedback": true,
        • "firehose": true,
        • "third_party_add_on_services": true,
        • "real_time_bidding": true,
        • "leadconduit_trustedform_decisions": true
        }
      }
    ],
  • "products": [],
  • "membership": {
    • "account_id": "5fd4371e940df5a34a3888b2",
    • "lc_access": true,
    • "sl_access": true,
    • "tf_access": true,
    • "product": "string",
    • "product_access": true,
    • "subscription_admin": true,
    • "user_admin": true,
    • "user_id": "5fd4371e940df5a34a3888b2"
    },
  • "permissions": {
    • "lcx": "string",
    • "suppressionlist": "string",
    • "trustedform": "string"
    },
  • "product_code": "lcx",
  • "company_name": "string",
  • "expires": "2019-08-24T14:15:22Z",
  • "subscriptions": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "created_at": "2019-08-24T14:15:22Z",
      • "updated_at": "2019-08-24T14:15:22Z",
      • "active_at": "2019-08-24T14:15:22Z",
      • "inactive_at": "2019-08-24T14:15:22Z",
      • "state": "string",
      • "account_id": "5fd4371e940df5a34a3888b2",
      • "product_offering_id": "string",
      • "product_offering": {
        • "id": "string",
        • "product_id": "string",
        • "component": "string",
        • "name": "string"
        }
      }
    ],
  • "zendesk_jwt": "string",
  • "created_at": "2019-08-24T14:15:22Z"
}
Create user settings
Create a new user settings document, adding it to the list of all user settings in the
account.


SecurityAPIKey 
Request 
Request Body schema: application/json
required
Create a new User Settings


required
object
User notification settings


 
Responses 
201
Created


post/user_settings
Request samples 
application/json
{
  • "notifications": {
    • "submission_doc_updates": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      },
    • "connection_invites": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      }
    }
}
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "notifications": {
    • "submission_doc_updates": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      },
    • "connection_invites": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      }
    },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z"
}
Get a user settings
Fetch a single user settings document.


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
The ID of the user


 
 Example:  5fd4371e940df5a34a3888b2
Responses 
200
OK


get/user_settings/{id}
Request samples 
Response samples 
application/json
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "notifications": {
    • "submission_doc_updates": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      },
    • "connection_invites": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      }
    },
  • "created_at": "2019-08-24T14:15:22Z",
  • "updated_at": "2019-08-24T14:15:22Z"
}
Update a user settings
Update an existing user settings document.


SecurityAPIKey 
Request 
path Parameters
id
required
string (ID) ^[0-9a-fA-F]{24}$
The ID of the user settings


 
 Example:  5fd4371e940df5a34a3888b2
Request Body schema: application/json
required
Update an existing User Settings


required
object
User notification settings


 
Responses 
200
OK


put/user_settings/{id}
Request samples 
application/json
{
  • "notifications": {
    • "submission_doc_updates": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      },
    • "connection_invites": {
      • "enabled": true,
      • "unsubscribed_at": "2019-08-24T14:15:22Z"
      }
    }
}
Response samples 
application/json
[
  • {
    • "id": "5fd4371e940df5a34a3888b2",
    • "notifications": {
      • "submission_doc_updates": {
        • "enabled": true,
        • "unsubscribed_at": "2019-08-24T14:15:22Z"
        },
      • "connection_invites": {
        • "enabled": true,
        • "unsubscribed_at": "2019-08-24T14:15:22Z"
        }
      },
    • "created_at": "2019-08-24T14:15:22Z",
    • "updated_at": "2019-08-24T14:15:22Z"
    }
]