Push Institution to CRM

Push a NationGraph institution to CRM as a new company.

Available fields to push:

From Institution:

• name → CRM name
• state → CRM state
• city → CRM city
• street → CRM address
• county → Appended to CRM description
• population → CRM numberofemployees
• label → CRM industry (mapped to valid enum, e.g., "K12 District" → "PRIMARY_SECONDARY_EDUCATION")

From Institution Metadata:

• website → CRM website (from homepage_url)
• description → CRM description (from entity_understanding)
• latitude → Appended to CRM description (hs_latitude is read-only)
• longitude → Appended to CRM description (hs_longitude is read-only)

Default fields (if not specified): name, state, city, street, website, description

Auto-mapping: By default, this will also create a CRM-institution mapping so you can reference this company in future operations. Set create_mapping: false to skip.

Owner assignment: Optionally assign the company to a CRM owner using owner_id. Get available owners via GET /crm/{integration_id}/owners.

Custom fields: Optionally write literal values to existing CRM custom fields on the new company using custom_fields (e.g. a "Source" field set to "Nationgraph"). Field names must match the CRM's API name (HubSpot property name or Salesforce field API name); fields that don't exist on the CRM org are silently skipped.