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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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)
| Parameter | Type | Description |
|---|---|---|
| include_archived | boolean | Include 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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"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,
"ui_writable": false,
"custom": true,
"archived": true,
"created_at": 1511192755,
"updated_at": 1511192755
}
]
}