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": {
    "base": {
      "state": "active",
      "product_offering_component": "partner",
      "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": {
      "state": "active",
      "product_offering_component": "partner",
      "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": {
      "state": "active",
      "product_offering_component": "partner",
      "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
  }
}
'
{
  "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": [
    {}
  ],
  "billing_type": "contracted",
  "financial_state": "paid",
  "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",
      "state": "active",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "product_offering_component": "partner",
      "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",
      "state": "active",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "product_offering_component": "partner",
      "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",
      "state": "active",
      "product_offering_id": "5fd4371e940df5a34a3888b2",
      "product_offering_component": "partner",
      "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

24 character alpha-numeric BSON identifier

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

"5fd4371e940df5a34a3888b2"

sso_id
string

24 character alpha-numeric BSON identifier

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

"5fd4371e940df5a34a3888b2"

api_key
string

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

name
string

Company name

Example:

"Acme, Inc."

time_zone
string
Example:

"America/New_York"

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

Only populated when the billing_type is "contracted"

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

"lcx"

state
string
connected_buyers
object[]

List of connected buyers

connected_sellers
object[]

List of connected sellers

pending_sellers
object[]

List of invited pending seller entities

pending_buyers
object[]

List of invited pending buyer entities

subscriptions
object
features
object