List Company Data Attributes

List Company attributes

You can fetch a list of all the company data attributes for your app by using https://api.intercom.io/data_attributes/company.

List of your company data attributes

Returns

List of data attributes

$ curl https://api.intercom.io/data_attributes/company \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json'
{
    "type": "data_attribute.list",
    "data_attributes": [
        {
            "type": "data_attribute",
            "name": "name",
            "full_name": "name",
            "label": "Company name",
            "description": "The name of a company",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "company_id",
            "full_name": "company_id",
            "label": "Company ID",
            "description": "A number identifying a company",
            "data_type": "string",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "last_request_at",
            "full_name": "last_request_at",
            "label": "Company last seen",
            "description": "The last day anyone from a company visited your site or app",
            "data_type": "date",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "remote_created_at",
            "full_name": "remote_created_at",
            "label": "Company created at",
            "description": "The day a company was added to Intercom",
            "data_type": "date",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "user_count",
            "full_name": "user_count",
            "label": "People",
            "description": "The number of people in a company",
            "data_type": "integer",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "session_count",
            "full_name": "session_count",
            "label": "Company web sessions",
            "description": "All visits from anyone in a company to your product's site or app",
            "data_type": "integer",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "website",
            "full_name": "website",
            "label": "Company website",
            "description": "The web address for the company's primary marketing site",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "subdomain",
            "full_name": "custom_attributes.subdomain",
            "label": "subdomain",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1500395363,
            "updated_at": 1500395363
        },
        {
            "type": "data_attribute",
            "name": "creation_source",
            "full_name": "custom_attributes.creation_source",
            "label": "creation_source",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1500477452,
            "updated_at": 1500477452
        },
        {
            "type": "data_attribute",
            "name": "paid_subscriber",
            "full_name": "custom_attributes.paid_subscriber",
            "label": "paid_subscriber",
            "data_type": "boolean",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1511192754,
            "updated_at": 1511192754
        },
        {
            "type": "data_attribute",
            "name": "team_mates",
            "full_name": "custom_attributes.team_mates",
            "label": "team_mates",
            "data_type": "integer",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1511192755,
            "updated_at": 1511192755
        }
    ]
}

By default a list of all unarchived data attributes is returned. You can include the following parameter to retrieve all the company data attributes for your app (i.e. including archived attributes)

ParameterTypeDescription
include_archivedbooleanInclude archived attributes in the list. By default we return only non archived data attributes

List of your company data attributes including archived

$ curl https://api.intercom.io/data_attributes/company?include_archived=true \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept: application/json'
{
    "type": "data_attribute.list",
    "data_attributes": [
        {
            "type": "data_attribute",
            "name": "name",
            "full_name": "name",
            "label": "Company name",
            "description": "The name of a company",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "company_id",
            "full_name": "company_id",
            "label": "Company ID",
            "description": "A number identifying a company",
            "data_type": "string",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "last_request_at",
            "full_name": "last_request_at",
            "label": "Company last seen",
            "description": "The last day anyone from a company visited your site or app",
            "data_type": "date",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "remote_created_at",
            "full_name": "remote_created_at",
            "label": "Company created at",
            "description": "The day a company was added to Intercom",
            "data_type": "date",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "user_count",
            "full_name": "user_count",
            "label": "People",
            "description": "The number of people in a company",
            "data_type": "integer",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "session_count",
            "full_name": "session_count",
            "label": "Company web sessions",
            "description": "All visits from anyone in a company to your product's site or app",
            "data_type": "integer",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "name",
            "full_name": "plan.name",
            "label": "Plan",
            "description": "A specific plan or level within your product that companies have signed up to",
            "data_type": "string",
            "api_writable": false,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "monthly_spend",
            "full_name": "monthly_spend",
            "label": "Monthly Spend",
            "description": "The monthly revenue you receive from a company",
            "data_type": "float",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "size",
            "full_name": "size",
            "label": "Company size",
            "description": "The number of people employed in this company, expressed as a single number",
            "data_type": "integer",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "industry",
            "full_name": "industry",
            "label": "Company industry",
            "description": "The category or domain this company belongs to e.g. 'ecommerce' or 'SaaS'",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "website",
            "full_name": "website",
            "label": "Company website",
            "description": "The web address for the company's primary marketing site",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": true,
            "custom": false,
            "archived": false
        },
        {
            "type": "data_attribute",
            "name": "subdomain",
            "full_name": "custom_attributes.subdomain",
            "label": "subdomain",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1500395363,
            "updated_at": 1500395363
        },
        {
            "type": "data_attribute",
            "name": "creation_source",
            "full_name": "custom_attributes.creation_source",
            "label": "creation_source",
            "data_type": "string",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1500477452,
            "updated_at": 1500477452
        },
        {
            "type": "data_attribute",
            "name": "paid_subscriber",
            "full_name": "custom_attributes.paid_subscriber",
            "label": "paid_subscriber",
            "data_type": "boolean",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1511192754,
            "updated_at": 1511192754
        },
        {
            "type": "data_attribute",
            "name": "team_mates",
            "full_name": "custom_attributes.team_mates",
            "label": "team_mates",
            "data_type": "integer",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": false,
            "created_at": 1511192755,
            "updated_at": 1511192755
        },
        {
            "type": "data_attribute",
            "name": "monthly_spend",
            "full_name": "custom_attributes.monthly_spend",
            "label": "monthly_spend",
            "data_type": "integer",
            "api_writable": true,
            "messenger_writable": false,
            "ui_writable": false,
            "custom": true,
            "archived": true,
            "created_at": 1511192755,
            "updated_at": 1511192755
        }
    ]
}