---
title: "Push NationGraph IDs to CRM"
method: POST
path: "/api/v3/crm/{integration_id}/mappings/push-nationgraph-ids"
tags: ["CRM Mappings"]
---

# Push NationGraph IDs to CRM

`POST /api/v3/crm/{integration_id}/mappings/push-nationgraph-ids`

Write each linked institution's NationGraph `unique_id` onto the CRM field chosen by `crm_field_name` (a HubSpot Company property or Salesforce Account field) for every mapped company/account. The field must already exist — it is never created. Skips records that already have the field set. Runs in the background.

## Path parameters

- `integration_id` string, uuid, required — The CRM integration ID

## Request body

- PushNationGraphIdsRequest — Request to push NationGraph IDs to a chosen CRM field.
  - `crm_field_name` string, required — Existing CRM field to write each institution's NationGraph unique_id into (HubSpot Company property name or Salesforce Account field API name). Must already exist — the field is never created. Discover available fields via GET /crm/{integration_id}/company-fields.
  - `crm_ids` string[], nullable — Optional scope: restrict the push to these CRM record IDs.

## Response `202`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/nationgraph/apis/nationgraph-api.md) · [All operations](https://skmtc.net/nationgraph/apis/nationgraph-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nationgraph/nationgraph-api/revisions/85804e68d86d/schema)