CRM

Push Signal to CRM

Push a signal to HubSpot CRM as either a note or a task.

Action Types:

note: Records the signal as a note on the HubSpot company. Use this to document the signal for future reference.
task: Creates a follow-up task on the HubSpot company. Use this when the signal requires action. Tasks include due dates, priority levels, and can be assigned to team members.

Requirements:

Active HubSpot integration
CRM mapping between the signal's institution and a HubSpot company (create via /api/v3/crm/{integration_id}/mappings)

post/api/v3/crm/{integration_id}/signals/{signal_id}

Request

Base URL
https://api.nationgraph.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/nationgraph/apis/nationgraph-api/docs/api/v3/crm/:integration_id/signals/:signal_id/post.ts
A function with typed inputs. Its response is checked against the schema.

integration_idstring uuid required

The CRM integration ID

signal_idstring required

The signal ID to push

action_type'note' | 'task' | 'post' | 'lead' required

Type of CRM action to perform on a signal.

subscription_idstring nullable

Target workflow subscription (Zap) chosen by the user. Only used for workflow providers like Zapier.

Successful Response

successboolean required

action_type'note' | 'task' | 'post' | 'lead' required

Type of CRM action to perform on a signal.

crm_idstring required

The created CRM object ID (note, task, post, or lead)

company_idstring required

The CRM company/account ID. Empty string for lead pushes since leads are not tied to a company.

messagestring required

No recorded changes to this operation across all 1 revision of this API.