---
title: "Add Account Properties"
method: POST
path: "/api/add_account_properties"
---

# Add Account Properties

`POST /api/add_account_properties`

This API allows you to attach custom account properties to users. An account ID or use of our Salesforce integration is required for this to work. Note that, as your set of accounts and their properties change, you’ll need to periodically call this API with an account ID as well as any account-level properties.

You will need to configure the Account ID setting before using this API to send your account data into Heap. Instructions to complete this and all of the other steps to analyze account data are available in the [Account Health Analysis](https://help.heap.io/analysis-examples/analysis-features/account-health-analysis/) guide.

Our Looker Actions integration allows you to quickly import property data into Heap. See the  [Looker Actions Integration guide](https://help.heap.io/integrations/other/looker-actions-integration/) to learn more.

## Request body

- object
  - `app_id` integer, required — The environment ID corresponding to one of your environments.
  - `account_id` string — Used for single account updates only. An ID for this account.
  - `properties` string, json — Used for single account updates only. An object with key-value properties you want associated with the account. Each key and property must either be a number or a string with fewer than 1024 characters.
  - `accounts` object[] — Used for bulk updates only. A list of objects with `account_id` and `properties` keys.
    - `account_id` string
    - `properties` object
      - `example_name` string

## Response `200`

200

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/heap/apis/server-side-api.md) · [All operations](https://skmtc.dev/heap/apis/server-side-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/heap/server-side-api/revisions/6cb04521d6fa/schema)