Skip to main content
PUT
/
account
Update account
curl --request PUT \
  --url https://app.leadconduit.com/account \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "data_retention_in_days": 123,
  "data_truncated_at": "2023-11-07T05:31:56Z",
  "subscriptions": {},
  "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
  }
}
'
{
  "id": "5fd4371e940df5a34a3888b2",
  "sso_id": "5fd4371e940df5a34a3888b2",
  "api_key": "<string>",
  "name": "Acme, Inc.",
  "time_zone": "America/New_York",
  "type": "<string>",
  "data_retention_in_days": 123,
  "data_truncated_at": "2023-11-07T05:31:56Z",
  "keen_project_id": "<string>",
  "keen_read_api_key": "<string>",
  "keen_write_api_key": "<string>",
  "pricing_components": [
    {}
  ],
  "financial_state_updated_at": "2023-11-07T05:31:56Z",
  "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": "2023-11-07T05:31:56Z"
    }
  ],
  "pending_buyers": [
    {
      "id": "5fd4371e940df5a34a3888b2",
      "name": "<string>",
      "expired": true,
      "invitation_expires_at": "2023-11-07T05:31:56Z"
    }
  ],
  "subscriptions": {
    "base": {
      "id": "5fd4371e940df5a34a3888b2",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "active_at": "2023-11-07T05:31:56Z",
      "inactive_at": "2023-11-07T05:31:56Z"
    },
    "pro": {
      "id": "5fd4371e940df5a34a3888b2",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "active_at": "2023-11-07T05:31:56Z",
      "inactive_at": "2023-11-07T05:31:56Z"
    },
    "partner": {
      "id": "5fd4371e940df5a34a3888b2",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "active_at": "2023-11-07T05:31:56Z",
      "inactive_at": "2023-11-07T05:31:56Z"
    }
  },
  "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
  }
}

Authorizations

Authorization
string
header
required

LeadConduit uses HTTP Basic Authentication with the username API and your API key as the password.

For example: API:1f1b96c9150d8050e858c043d543bb4eadae0e6f'

Body

application/json

Update an existing Account

Details of the company 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>
subscriptions
object
features
object

Response

200 - application/json

OK

Details of the company account

id
string
required
read-only

24 character alpha-numeric BSON identifier

Pattern: ^[0-9a-fA-F]{24}$
Example:

"5fd4371e940df5a34a3888b2"

sso_id
string
read-only

24 character alpha-numeric BSON identifier

Pattern: ^[0-9a-fA-F]{24}$
Example:

"5fd4371e940df5a34a3888b2"

api_key
string
read-only

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

name
string
read-only

Company name

Example:

"Acme, Inc."

time_zone
string
read-only
Example:

"America/New_York"

type
string
read-only
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>
keen_project_id
string
read-only
keen_read_api_key
string
read-only
keen_write_api_key
string
read-only
pricing_components
object[]
read-only
billing_type
enum<string>
read-only
Available options:
contracted,
self_service
financial_state
enum<string>
read-only

Only populated when the billing_type is "contracted"

Available options:
paid,
unpaid
financial_state_updated_at
string<date-time>
read-only
lead_ping_enabled
boolean
read-only
product_id
string
read-only
Example:

"lcx"

state
string
read-only
connected_buyers
object[]
read-only

List of connected buyers

connected_sellers
object[]
read-only

List of connected sellers

pending_sellers
object[]
read-only

List of invited pending seller entities

pending_buyers
object[]
read-only

List of invited pending buyer entities

subscriptions
object
features
object