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)

enterprise
boolean
Deprecated

Use "billing_type" property instead. "billing_type: contracted" is equivalent to "enterprise: true".

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
self_service_status
string
Deprecated
self_service_status_updated_at
string <date-time> (Timestamp)
Deprecated

Use "financial_state_updated_at" property instead.

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)
cancelled_at
string <date-time> (Timestamp)
coupon_code
string
marketing_reference
string
lead_ping_enabled
boolean
product_id
string
state
string
Array of objects

List of connected buyers

Array of objects

List of connected sellers

object
object
{
  • "id": "5fd4371e940df5a34a3888b2",
  • "sso_id": "5fd4371e940df5a34a3888b2",
  • "api_key": "string",
  • "enterprise": true,
  • "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": [
    • { }
    ],
  • "self_service_status": "string",
  • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "cancelled_at": "2019-08-24T14:15:22Z",
  • "coupon_code": "string",
  • "marketing_reference": "string",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "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

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
{
  • "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",
      • "enterprise": true,
      • "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": [
        • { }
        ],
      • "self_service_status": "string",
      • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "cancelled_at": "2019-08-24T14:15:22Z",
      • "coupon_code": "string",
      • "marketing_reference": "string",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "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": [],
  • "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"
}

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",
  • "enterprise": true,
  • "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": [
    • { }
    ],
  • "self_service_status": "string",
  • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "cancelled_at": "2019-08-24T14:15:22Z",
  • "coupon_code": "string",
  • "marketing_reference": "string",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "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",
  • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "cancelled_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",
  • "enterprise": true,
  • "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": [
    • { }
    ],
  • "self_service_status": "string",
  • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
  • "billing_type": "contracted",
  • "financial_state": "paid",
  • "financial_state_updated_at": "2019-08-24T14:15:22Z",
  • "cancelled_at": "2019-08-24T14:15:22Z",
  • "coupon_code": "string",
  • "marketing_reference": "string",
  • "lead_ping_enabled": true,
  • "product_id": "lcx",
  • "state": "string",
  • "connected_buyers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "connected_sellers": [
    • {
      • "id": "5fd4371e940df5a34a3888b2",
      • "name": "string"
      }
    ],
  • "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",
      • "enterprise": true,
      • "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": [
        • { }
        ],
      • "self_service_status": "string",
      • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "cancelled_at": "2019-08-24T14:15:22Z",
      • "coupon_code": "string",
      • "marketing_reference": "string",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "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": [],
  • "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"
}

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",
      • "enterprise": true,
      • "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": [
        • { }
        ],
      • "self_service_status": "string",
      • "self_service_status_updated_at": "2019-08-24T14:15:22Z",
      • "billing_type": "contracted",
      • "financial_state": "paid",
      • "financial_state_updated_at": "2019-08-24T14:15:22Z",
      • "cancelled_at": "2019-08-24T14:15:22Z",
      • "coupon_code": "string",
      • "marketing_reference": "string",
      • "lead_ping_enabled": true,
      • "product_id": "lcx",
      • "state": "string",
      • "connected_buyers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "connected_sellers": [
        • {
          • "id": "5fd4371e940df5a34a3888b2",
          • "name": "string"
          }
        ],
      • "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": [],
  • "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"
}