コンタクトレコードには、個人に関する情報が保存されます。コンタクトエンドポイントを使用することにより、コンタクトデータを管理したり、HubSpotと他のシステムとの間で同期したりできます。
POST
リクエストを/crm/v3/objects/notes
に送信します。
リクエスト本文で、propertiesオブジェクト内にメモの詳細を追加します。また、associationsオブジェクトを追加して、新しいメモを既存のレコード(コンタクト、会社など)に関連付けることもできます。
フィールド | 説明 |
---|---|
hs_timestamp | 必須。このフィールドは、メモの作成時刻を記録し、レコードタイムラインでのそのメモの表示位置を決定します。ミリ秒単位またはUTC形式のUnixタイムスタンプを使用できます。 |
hs_note_body | メモのテキストコンテンツ。65,536文字までに制限されています。 |
hubspot_owner_id | メモに関連付けられている担当者のID。このフィールドにより、HubSpotのレコードタイムラインにメモ作成者として表示されるユーザーが決まります。 |
hs_attachment_ids | メモの添付ファイルのID。複数の添付ファイルIDはそれぞれセミコロンで区切られます。 |
フィールド | 説明 |
---|---|
to | メモに関連付けるレコード。一意のid 値で指定します。 |
types | メモとレコードの間の関連付けのタイプ。associationCategory およびassociationTypeId を含めます。デフォルトの関連付けタイプIDはこちらのページに記載されています。または、関連付けAPIを使用して、カスタムの関連付けタイプ(ラベル)の値を取得することもできます。 |
GET
リクエストを/crm/v3/objects/notes/{noteId}
に送信します。
全てのメモのリストを取得するには、GET
リクエストを/crm/v3/objects/notes
に送信します。
どちらのエンドポイントに対しても、リクエストのURLに次のクエリーパラメーターを含めることができます。
パラメーター | 説明 |
---|---|
properties | レスポンスで返される、プロパティーのカンマ区切りのリスト。リクエスト対象のメモで、指定したプロパティーに値が設定されていない場合、そのプロパティーはレスポンスに含まれません。 |
associations | 関連付けられているIDが取得されるオブジェクトタイプのカンマ区切りのリスト。存在しない関連付けを指定した場合、その関連付けはレスポンスで返されません。詳しくは関連付けAPIをご参照ください。 |
https://api.hubapi.com/crm/v3/objects/notes?limit=10&properties=hs_note_body&associations=contact&archived=false
内部IDまたは一意のプロパティー値によってメモを一括で取得する方法については、リファレンスドキュメントをご参照ください。
PATCH
リクエストを/crm/v3/objects/notes/{noteId}
に送信します。
リクエスト本文には次のように更新するメモプロパティーを含めます。
PUT
リクエストを/crm/v3/objects/notes/{noteId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}
に送信します。リクエストのURLには次のフィールドが含まれます。
フィールド | 説明 |
---|---|
noteId | メモのID。 |
toObjectType | メモに関連付けるオブジェクトのタイプ(コンタクト、会社など)。 |
toObjectId | メモに関連付けるレコードのID。 |
associationTypeId | メモと他のオブジェクトとの関連付けタイプを示す一意の識別子。このIDは、数値またはスネークケース(例:note_to_contact )で表すことができます。該当する値は関連付けAPIを介して取得できます。 |
https://api.hubspot.com/crm/v3/objects/notes/17147287858/associations/contact/581751/202
DELETE
リクエストを送信します。
/crm/v3/objects/notes/{noteId}/associations/{toObjectType}/{toObjectId}/{associationTypeId}
hs_pinned_engagement_id
フィールドにメモのid
を含めます。詳しくは、会社、コンタクト、取引、チケット、およびカスタムオブジェクトのAPIの使用に関する説明をご参照ください。
DELETE
リクエストを/crm/v3/objects/notes/{noteId}
に送信します。
メモの削除について詳しくは、リファレンスドキュメントをご参照ください。