API docs by Redocly

Mazrica Sales Open API (v2)

Download OpenAPI specification:

v2 APIは段階的にリリース予定です

現在未掲載のエンドポイントは今後のフェーズで公開予定です。公開までの間は引き続きv1 APIをご利用ください。
旧APIリファレンス（v1）はこちら

Overview

Mazrica Sales のデータを操作するための公開 API (v2) です。本ドキュメントをご確認のうえご利用ください。API は随時拡張していきます。

Introduction

オンラインマニュアル: MazricaAPIを利用する – Mazrica

Endpoints

API のエンドポイントのベース URL は以下です。バージョンの v2 を含めてリクエストしてください。

https://api.mazrica.com/v2/{PATH_TO_REQUEST}

Authentication

認証は PAT（Personal Access Token, mzp_ プレフィックス）または TAT（Team Access Token, mzt_ プレフィックス）による Bearer 認証です。すべてのリクエストの Authorization ヘッダーに Bearer トークンを指定してください。

Authorization: Bearer mzp_xxxxxxxxxxxxxxxx
Content-Type: application/json

curl の例:

curl -X GET 'https://api.mazrica.com/v2/deals' \
  -H 'Authorization: Bearer mzp_xxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json'

トークン種別と権限

  • PAT（mzp_）: 権限設定 を利用しているドメインでは、トークンを発行したユーザーの権限が適用されます。閲覧・操作できる範囲はそのユーザーのロールに従い、権限外のデータは取得・操作できません。一覧・検索では権限のあるデータのみがヒットし、権限不足でも 403 ではなくスコープ内の結果（該当なしの場合は空）を返します。権限設定 を利用していないドメインでは制限はありません。
  • TAT（mzt_）: ユーザー権限による絞り込みはなく、ドメイン内のデータを制限なく操作できます。

Requests Limit

レート制限を超えた場合は 429 Too Many Requests を返します。日次の上限は UTC 0 時境界でリセットされます。

トークン種別 集計単位 秒間上限 日次上限
PAT (mzp_) ユーザー単位（同一ユーザーの複数 PAT を合算） 5 req/sec 50,000
TAT (mzt_) ドメイン単位（同一ドメインの複数 TAT を合算） 5 req/sec 200,000

Sort

一覧取得（GET）

一覧を返す API は sort クエリパラメータで並び順を指定できます。キーの前に - を付けると降順になります。指定できるキーと既定の並び順はエンドポイントごとに異なるため、各エンドポイントの sort パラメータの説明を参照してください。

  • 例: GET /v2/customers?sort=createdAt（作成日時の昇順）、GET /v2/customers?sort=-updatedAt（更新日時の降順）

取引先(Customers)

取引先情報リスト

取引先一覧をカーソルページネーション形式で取得します。

  • レスポンスは v1同様の customers キー ({ customers, hasMore, nextCursor, totalCount })
  • v1 GET /api/v1/customers と互換のあるデータを、v2 形式で提供します
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

1ページあたりの件数。最大1000。省略した場合、デフォルトは100。

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

searchWord
string

指定した文字列と取引先名が部分一致する取引先を検索します。

updatedAtFrom
string <date-time>

更新日時による検索範囲(開始)

  • ex) 2018-04-01T10:30:00
updatedAtTo
string <date-time>

更新日時による検索範囲(終了)

  • ex) 2018-04-01T10:30:00
sort
string
Default: "-updated_at"
Enum: "updated_at" "-updated_at" "created_at" "-created_at" "updatedAt" "-updatedAt" "createdAt" "-createdAt"

並び順 ソート可能 updatedAt、createdAt

itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 customerCustoms を item_key をキーにしたオブジェクト形式で返す

Responses

Response samples

Content type
application/json
{
  • "customers": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

取引先情報登録

取引先を登録します。

  • 入力値の型不正は 400 BAD_REQUEST、バリデーション失敗は 400 VALIDATION_FAILED
Authorizations:
bearer_auth
Request Body schema: application/json
required
name
required
string

取引先名

address
string or null

住所

telNo
string or null

電話番号

webUrl
string or null

WebサイトURL

employee
integer or null

従業員数

capital
integer or null

資本金

closingMonth
integer or null

決算月（1〜12）

establishYear
integer or null

設立年

industryId
integer or null

業種ID

ownerRoleId
integer or null

担当ロールID

parentId
integer or null

親取引先ID

companyNum
string or null

法人番号

Array of objects (CustomerCustomCreateParam)

取引先詳細項目の登録値の配列。項目は customerCustomItemId か itemKey で特定する

Array of objects (CustomObjectAssociationParam)

カスタムオブジェクトの関連付け

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "address": "string",
  • "telNo": "string",
  • "webUrl": "string",
  • "employee": 0,
  • "capital": 0,
  • "closingMonth": 0,
  • "establishYear": 0,
  • "industryId": 0,
  • "ownerRoleId": 0,
  • "parentId": 0,
  • "companyNum": "string",
  • "customerCustoms": [
    ],
  • "customObjects": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "companyNum": "string",
  • "establishYear": 0,
  • "industry": {
    },
  • "address": "string",
  • "telNo": "string",
  • "webUrl": "string",
  • "employee": 0,
  • "capital": 0,
  • "company": {
    },
  • "closingMonth": 0,
  • "ownerRole": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "customerCustoms": [
    ]
}

取引先情報検索

取引先情報を検索します。v1 POST /api/v1/customers/search と同形式の compositeFilter を受け付けます。

  • ページングは page に代えてカーソル形式 (limit / cursor / nextCursor / hasMore)。totalCount は維持
  • レスポンスのトップキーは customers（v1 互換）
  • 検索は検索インデックスで実行されます。filter / sort に指定できる標準項目は検索インデックス収録のものに限られ、それ以外は 400 になります
  • customerCustoms は軽量形（compact）で常に返します
  • 並び順は request body の sort で指定できます（例: name / updated_at / created_at）。省略時は updated_at 降順（id 昇順タイブレーク）
Authorizations:
bearer_auth
Request Body schema: application/json
required
filter
required
object

compositeFilter / valueFilter による検索条件（v1 互換）

object

ソート条件（省略時 updated_at 降順）

limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 customerCustoms を item_key をキーにしたオブジェクト形式で返す

Responses

Request samples

Content type
application/json
{
  • "filter": { },
  • "sort": {
    },
  • "limit": 100,
  • "cursor": "string",
  • "itemKeyAsPropertyKey": "true"
}

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "nextCursor": "string",
  • "hasMore": true,
  • "customers": [
    ]
}

取引先情報

取引先情報を取得します。

  • レスポンスはリソースオブジェクトを素で返します
  • include_related_objects=1 を指定するとカスタムオブジェクト連携情報（customObjects）を含みます
Authorizations:
bearer_auth
path Parameters
id
required
integer

取引先ID

query Parameters
itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 customerCustoms を item_key をキーにしたオブジェクト形式で返す

include_related_objects
integer
Default: 0

1 を指定すると、関連付けオブジェクトの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "companyNum": "string",
  • "establishYear": 0,
  • "industry": {
    },
  • "address": "string",
  • "telNo": "string",
  • "webUrl": "string",
  • "employee": 0,
  • "closingMonth": 0,
  • "capital": 0,
  • "company": {
    },
  • "ownerRole": {
    },
  • "customerCustoms": [
    ],
  • "customObjects": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

取引先情報更新

  • 取引先情報を更新します。リクエストに含まれた項目のみ更新されます（部分更新）。
Authorizations:
bearer_auth
path Parameters
id
required
integer

取引先ID

Request Body schema: application/json
required
name
string

取引先名

address
string or null

住所

telNo
string or null

電話番号

webUrl
string or null

URL

employee
integer or null

従業員数

capital
integer or null

資本金

closingMonth
integer or null

決算月（1〜12）

establishYear
integer or null

設立年（西暦）

industryId
integer or null

業種ID

ownerRoleId
integer or null

ロールID

companyNum
string or null

企業番号

Array of objects

取引先詳細項目

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "address": "string",
  • "telNo": "string",
  • "webUrl": "string",
  • "employee": 0,
  • "capital": 0,
  • "closingMonth": 0,
  • "establishYear": 0,
  • "industryId": 0,
  • "ownerRoleId": 0,
  • "companyNum": "string",
  • "customerCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "companyNum": "string",
  • "establishYear": 0,
  • "industry": {
    },
  • "address": "string",
  • "telNo": "string",
  • "webUrl": "string",
  • "employee": 0,
  • "capital": 0,
  • "company": {
    },
  • "closingMonth": 0,
  • "ownerRole": {
    },
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "customerCustoms": [
    ]
}

取引先情報削除

指定した取引先を削除します。

  • 成功時はレスポンスボディなしで 200 を返す（v1同様）
  • 関連する案件・コンタクト・行動等の子レコードも同時に削除されます（物理削除のため復元できません）
Authorizations:
bearer_auth
path Parameters
id
required
integer

取引先ID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

取引先一括登録

取引先を一括登録します（v1同様の同期実行）。

  • 成功時は作成した取引先IDの配列を返します
  • 処理はall-or-nothingで、1件でも失敗すると全件ロールバックされます
  • 1リクエストあたりの上限は 1000 件です。
  • このAPIを使って登録した場合、PAT認証時のみ監査ログが記録されます（TAT認証時は記録されません）。
Authorizations:
bearer_auth
Request Body schema: application/json
required
required
Array of objects (CustomerBulkCreateItem) <= 1000 items

登録する取引先の配列

Responses

Request samples

Content type
application/json
{
  • "customers": [
    ]
}

Response samples

Content type
application/json
[
  • 0
]

取引先アクション(CustomerActions)

取引先アクション情報リスト

指定した取引先に紐づくアクション一覧をカーソルページネーション形式で取得します。

  • レスポンスは v1 と同じエンベロープ（{ totalCount, nextCursor, hasMore, actions }）。v1 の page はカーソルページネーションに置き換え
  • v1 互換: customer_id に all を指定すると全取引先のアクションを対象とする
  • 指定したcustomer_idが存在しない場合は 404
  • 指定したcustomer_idへの参照権限がない場合は 403
  • 取引先アクション参照 権限が無い場合は 403 ではなく 200 ＋ 空配列を返す
Authorizations:
bearer_auth
path Parameters
required
integer or string

取引先IDを指定してアクションを検索します。

取引先IDの代わりに、allと指定することで取引先IDを跨いだアクションの取得が可能です。

query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

sort
string
Default: "-startDatetime"
Enum: "startDatetime" "-startDatetime" "start_datetime" "-start_datetime"

並び順 ソート可能 startDatetime

startDatetime
string <date-time>
Example: startDatetime=2018-04-01T10:30:00+09:00

開始日時

ex)

  • startDatetime=2019-01-01T09:00:00+09:00
  • endDatetime=2019-01-01T11:00:00+09:00

上記のように指定した場合、開始日時2019-01-01 09:00 から 終了日時2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

endDatetime
string <date-time>
Example: endDatetime=2018-04-01T10:30:00+09:00

終了日時

ex)

  • startDatetime=2019-01-01T09:00:00+09:00
  • endDatetime=2019-01-01T11:00:00+09:00

上記のように指定した場合、開始日時2019-01-01 09:00 から 終了日時2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

createdAtFrom
string <date-time>
Example: createdAtFrom=2018-04-01T10:30:00+09:00

登録日時開始時間

ex)

  • createdAtFrom=2019-01-01T09:00:00+09:00
  • createdAtTo=2019-01-01T11:00:00+09:00

上記のように指定した場合、登録日時が2019-01-01 09:00 から 2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

createdAtTo
string <date-time>
Example: createdAtTo=2018-04-01T10:30:00+09:00

登録日時終了時間

ex)

  • createdAtFrom=2019-01-01T09:00:00+09:00
  • createdAtTo=2019-01-01T11:00:00+09:00

上記のように指定した場合、登録日時が2019-01-01 09:00 から 2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

updatedAtFrom
string <date-time>
Example: updatedAtFrom=2018-04-01T10:30:00+09:00

最終更新日時開始時間

ex)

  • updatedAtFrom=2019-01-01T09:00:00+09:00
  • updatedAtTo=2019-01-01T11:00:00+09:00

上記のように指定した場合、最終更新日時が2019-01-01 09:00 から 2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

updatedAtTo
string <date-time>
Example: updatedAtTo=2018-04-01T10:30:00+09:00

最終更新日時終了時間

ex)

  • updatedAtFrom=2019-01-01T09:00:00+09:00
  • updatedAtTo=2019-01-01T11:00:00+09:00

上記のように指定した場合、最終更新日時が2019-01-01 09:00 から 2019-01-01 11:00（JST）のアクションを検索します。

日時は ISO 8601 形式でタイムゾーンを明示して指定してください（UTC: 2019-01-01T00:00:00Z または JST: 2019-01-01T09:00:00+09:00）。省略時はUTCとして解釈されます。

users[][id]
Array of integers

アクション担当者、その他の担当者を検索します。

GETパラメータで指定する場合、以下の形式で指定します。

?users[][id]=1&users[][id]=2

pattern
integer

アクションの種別

active
string
Enum: "true" "false"

true:予定 false:完了

Responses

Response samples

Content type
application/json
{
  • "totalCount": 0,
  • "nextCursor": "string",
  • "hasMore": true,
  • "actions": [
    ]
}

取引先アクション登録

取引先アクションを新規登録します。

  • pattern、startDatetime、endDatetime、creator は必須
  • 関連リソースID（creator / invitees / contacts）が存在しない・別ドメインの場合は 404
Authorizations:
bearer_auth
path Parameters
customer_id
required
integer

取引先ID

Request Body schema: application/json
required
object

アクションパターン（アクション種別）

startDatetime
required
string <date-time>

開始日時

endDatetime
required
string <date-time>

終了日時

required
object

主担当者（担当者）

Array of objects

その他担当者（招待ユーザー）

Array of objects

アクションに紐づけるコンタクト

preNote
string or null

事前メモ

result
string or null

アクションの実施結果

active
boolean

アクションの完了状態。false で完了アクションとして登録します。

Array of objects

アクション詳細項目

Responses

Request samples

Content type
application/json
{
  • "pattern": {
    },
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "creator": {
    },
  • "invitees": [
    ],
  • "contacts": [
    ],
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "actionCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "string",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "customer": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

取引先アクション情報

  • アクション情報を取得
Authorizations:
bearer_auth
path Parameters
customer_id
required
integer

取引先ID

id
required
integer

アクションID

query Parameters
include_files
integer

1 を指定すると、添付ファイルの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "files": [
    ],
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "外部サービスなどから取り込んだ,\nアクションの実施結果",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "customer": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

取引先アクション情報更新

取引先アクションを更新します。

  • 指定したフィールドのみ更新します（部分更新）
  • invitees を指定した場合は全量置き換えになります
Authorizations:
bearer_auth
path Parameters
customer_id
required
integer

取引先ID

id
required
integer

アクションID

Request Body schema: application/json
object

アクションパターン

startDatetime
string <date-time>

開始日時

endDatetime
string <date-time>

終了日時

object

アクション担当者ID

preNote
string or null

アクションの事前メモ

result
string or null

アクションの実施結果

active
boolean

アクションの状態(true=未完了、false=完了)

Array of objects

他の担当者

Array of objects

アクションコンタクト

Array of objects

アクション詳細項目一覧

Responses

Request samples

Content type
application/json
{
  • "pattern": {
    },
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "creator": {
    },
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "invitees": [
    ],
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "string",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "customer": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

取引先アクション情報削除

  • アクション情報を削除
  • 削除成功時はレスポンスボディなし（200 OK）
Authorizations:
bearer_auth
path Parameters
customer_id
required
integer

取引先ID

id
required
integer

アクションID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

取引先アクション一括登録

取引先アクションを一括登録します。

  • 一度に登録可能な上限は1000件です
  • 1件でもエラーがある場合は全件登録されません
  • このAPIを使って登録した場合、監査ログは記録されません
Authorizations:
bearer_auth
Request Body schema: application/json
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "actions": [
    ]
}

Response samples

Content type
application/json
[
  • 0
]

案件(Deals)

案件情報リスト

案件一覧をカーソルページネーション形式で取得します

  • レスポンスは v1 と同じ deals キーの配列を含む構造 ({ deals, hasMore, nextCursor, totalCount })
  • 10,000 件超のデータでもカーソル経由で順次取得可能
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

searchWord
string

案件名・取引先名による部分一致検索（v1と同じ）

dealTypeId
integer

案件タイプIDによる絞り込み（v1と同じ）

sort
string

並び順。- プレフィックスで降順。省略時は更新日時の降順。 ソート可能 updatedAt、createdAt

updatedAtFrom
string <date-time>
Example: updatedAtFrom=2018-04-01T10:30:00+09:00

最終更新日時フィルタ（以降）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

updatedAtTo
string <date-time>
Example: updatedAtTo=2018-04-01T10:30:00+09:00

最終更新日時フィルタ（以前）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 dealCustoms を item_key をキーにしたオブジェクト形式で返す

Responses

Response samples

Content type
application/json
{
  • "deals": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

案件情報登録

案件を登録します。

  • 関連リソース（customer / dealType / phase / product / probability / channel / user）は { "id": N } 形式で指定
  • 関連リソースIDが存在しない/別ドメインの場合は 404
  • 入力値の型不正は 400 Bad Request、バリデーション失敗は 400 Validation Failed
Authorizations:
bearer_auth
query Parameters
itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 dealCustoms を item_key をキーにしたオブジェクト形式で返す（v1と同じ）

Request Body schema: application/json
required
name
required
string

案件名

amount
integer or null

契約金額

expectedContractDate
required
string <date>

契約予定日（YYYY-MM-DD）

reason
string or null

理由（フェーズが進行中以外のときに endPhaseReasonIds とどちらか必須）

required
object

取引先

required
object

案件タイプ

required
object

フェーズ

required
object

商品

required
object

契約確度

required
object

チャネル

required
object

担当者

endPhaseReasonIds
Array of integers

最終・停止理由区分のID配列（フェーズが進行中以外のときに reason とどちらか必須）

Array of objects (DealCustomCreateParam)

案件詳細項目の登録値の配列。項目は dealCustomItemId か itemKey で特定する

Array of objects (DealProductDetailCreateParam)

商品内訳の配列

Array of objects (DealCustomerCreateParam)

関連取引先の配列

Array of objects (CustomObjectAssociationParam)

カスタムオブジェクトの関連付け

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "amount": 0,
  • "expectedContractDate": "2019-08-24",
  • "reason": "string",
  • "customer": {
    },
  • "dealType": {
    },
  • "phase": {
    },
  • "product": {
    },
  • "probability": {
    },
  • "channel": {
    },
  • "user": {
    },
  • "endPhaseReasonIds": [
    ],
  • "dealCustoms": [
    ],
  • "dealProductDetails": [
    ],
  • "dealCustomers": [
    ],
  • "customObjects": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "amount": 0,
  • "closingLeadtime": 0,
  • "fromEmail": true,
  • "memo": "string",
  • "expectedContractDate": "2019-08-24",
  • "reason": "string",
  • "totalCost": "string",
  • "totalProfit": "string",
  • "dealType": {
    },
  • "customer": {
    },
  • "phase": {
    },
  • "product": {
    },
  • "probability": {
    },
  • "channel": {
    },
  • "user": {
    },
  • "endPhaseReasons": [
    ],
  • "phaseStayDays": [
    ],
  • "dealProductDetails": [
    ],
  • "dealCustomerTypes": [
    ],
  • "dealCustoms": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

案件情報検索

案件情報を検索します。

  • レスポンスはカーソルページネーション形式 ({ deals, hasMore, nextCursor, totalCount })
  • dealCustoms は常時返却（compactCustoms=true相当で型別フィールドのみ。noCustoms/compactCustomsのクライアント指定は不可）
  • 検索は検索インデックスで実行されます。filter / sort に指定できる標準項目は検索インデックス収録のものに限られ、それ以外は 400 になります
  • 並び順は request body の sort で指定できます（例: name / updated_at / created_at）。省略時は updated_at 降順（id 昇順タイブレーク）
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

Request Body schema: application/json
required
required
object (DealSearchFilter)

絞り込み条件

  • compositeFilter と valueFilter を合わせて最大300個まで指定できます(最上位の compositeFilter は件数に含まれません)。
object (DealSearchSort)

並び順。省略時は updated_at 降順（id 昇順タイブレーク）。 項目値が NULL のレコードは、昇順では先頭・降順では末尾に並びます。

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": {
    }
}

Response samples

Content type
application/json
{
  • "deals": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

案件情報

案件詳細を取得します。

  • レスポンスはリソースオブジェクトを素で返します
  • include_related_objects=1 を指定すると関連カスタムオブジェクト情報（customObjects）を含みます
Authorizations:
bearer_auth
path Parameters
id
required
integer

案件ID

query Parameters
itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 dealCustoms を item_key をキーにしたオブジェクト形式で返す

include_related_objects
integer
Default: 0

1 を指定すると、関連付けオブジェクトの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "amount": 0,
  • "closingLeadtime": 0,
  • "fromEmail": true,
  • "memo": "string",
  • "expectedContractDate": "2019-08-24",
  • "reason": "string",
  • "totalCost": "string",
  • "totalProfit": "string",
  • "dealType": {
    },
  • "customer": {
    },
  • "phase": {
    },
  • "product": {
    },
  • "probability": {
    },
  • "channel": {
    },
  • "user": {
    },
  • "endPhaseReasons": [
    ],
  • "phaseStayDays": [
    ],
  • "dealProductDetails": [
    ],
  • "dealCustomerTypes": [
    ],
  • "dealCustoms": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

案件情報更新

案件を部分更新（PATCH）します。

  • リクエストに含めたキーのみ更新する（部分更新）
  • 関連リソース（customer / phase / product / probability / channel / user）は { "id": N } 形式で指定
  • 対象案件 / 関連リソースIDが存在しない・別ドメインの場合は 404 NOT_FOUND
  • 入力値の型不正は 400 BAD_REQUEST、バリデーション失敗は 400 VALIDATION_FAILED
Authorizations:
bearer_auth
path Parameters
id
required
integer

案件ID

query Parameters
itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 dealCustoms を item_key をキーにしたオブジェクト形式で返す（v1と同じ）

Request Body schema: application/json
required
name
string

案件名

amount
integer or null

契約金額

expectedContractDate
string <date>

契約予定日（YYYY-MM-DD）

reason
string or null

理由（フェーズが進行中以外のときに endPhaseReasonIds とどちらか必須）

object

取引先

object

フェーズ

object

商品

object

契約確度

object

チャネル

object

担当者

endPhaseReasonIds
Array of integers

最終・停止理由区分のID配列（フェーズが進行中以外のときに reason とどちらか必須）

Array of objects (DealCustomUpdateParam)

案件詳細項目の更新値の配列。項目は id / dealCustomItemId / itemKey で特定する

Array of objects (DealProductDetailUpdateParam)

商品内訳の配列（id 指定で更新、deleted で削除、id なしで追加）

Array of objects (DealCustomerUpdateParam)

関連取引先の配列（delete で解除）

Array of objects (CustomObjectAssociationParam)

カスタムオブジェクトの関連付け

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "amount": 0,
  • "expectedContractDate": "2019-08-24",
  • "reason": "string",
  • "customer": {
    },
  • "phase": {
    },
  • "product": {
    },
  • "probability": {
    },
  • "channel": {
    },
  • "user": {
    },
  • "endPhaseReasonIds": [
    ],
  • "dealCustoms": [
    ],
  • "dealProductDetails": [
    ],
  • "dealCustomers": [
    ],
  • "customObjects": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "amount": 0,
  • "closingLeadtime": 0,
  • "fromEmail": true,
  • "memo": "string",
  • "expectedContractDate": "2019-08-24",
  • "reason": "string",
  • "totalCost": "string",
  • "totalProfit": "string",
  • "dealType": {
    },
  • "customer": {
    },
  • "phase": {
    },
  • "product": {
    },
  • "probability": {
    },
  • "channel": {
    },
  • "user": {
    },
  • "endPhaseReasons": [
    ],
  • "phaseStayDays": [
    ],
  • "dealProductDetails": [
    ],
  • "dealCustomerTypes": [
    ],
  • "dealCustoms": [
    ],
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

案件情報削除

指定した案件を削除します。

  • 成功時はレスポンスボディなしで 200 を返す（v1同様。204は返さない）
Authorizations:
bearer_auth
path Parameters
id
required
integer

案件ID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

案件一括登録

案件を一括登録します（v1同様の同期実行）。

  • 案件タイプはパスパラメータ dealTypeId で指定します
  • 成功時は作成した案件IDの配列を返します
  • 処理はall-or-nothingで、1件でも失敗すると全件ロールバックされます
  • 1リクエストあたりの上限は 1000 件です。
Authorizations:
bearer_auth
path Parameters
dealTypeId
required
integer

案件タイプID

Request Body schema: application/json
required
required
Array of objects (DealBulkCreateItem)

登録する案件の配列（最大1000件）

Responses

Request samples

Content type
application/json
{
  • "deals": [
    ]
}

Response samples

Content type
application/json
[
  • 0
]

案件一括更新

案件を一括更新します（v1同様の同期実行）。

  • 案件タイプはパスパラメータ dealTypeId で指定します
  • 各案件は id で既存レコードを特定し、送信したフィールドのみ更新します（部分更新）
  • 成功時は更新した案件（deals）とスキップした案件（skippedDeals）を返します
  • 案件ロック中（受注・失注フェーズ）の案件のロック対象項目を更新しようとした場合、その案件はスキップされ skippedDeals に含まれます（PAT のみ対象・TAT はロック無視）
  • 処理はall-or-nothingで、1件でも失敗すると全件ロールバックされます
  • 1リクエストあたりの上限は 1000 件です。
Authorizations:
bearer_auth
path Parameters
dealTypeId
required
integer

案件タイプID

Request Body schema: application/json
required
required
Array of objects (DealBulkUpdateItem)

更新する案件の配列（最大1000件）

Responses

Request samples

Content type
application/json
{
  • "deals": [
    ]
}

Response samples

Content type
application/json
{
  • "deals": [
    ],
  • "skippedDeals": [
    ]
}

案件コンタクト(DealsContacts)

案件コンタクトリスト

指定した案件に紐づくコンタクト一覧をv1同様のページ方式で取得します。

  • レスポンスは v1同様の contacts キー ({ contacts, totalCount, page })
Authorizations:
bearer_auth
path Parameters
deal_id
required
integer

案件ID

query Parameters
page
integer >= 1
Default: 1

ページ番号（1始まり）。未指定時は1ページ目

Responses

Response samples

Content type
application/json
{
  • "contacts": [
    ],
  • "totalCount": 0,
  • "page": 0
}

案件コンタクト情報登録

Authorizations:
bearer_auth
path Parameters
deal_id
required
integer

案件ID

contact_id
required
integer

コンタクトID

Responses

Response samples

Content type
application/json
{
  • "error": "Bad Request",
  • "messages": [
    ]
}

案件コンタクト情報削除

指定した案件からコンタクトの紐付けを削除します。

  • 成功時はレスポンスボディなしで 200 を返す（v1同様。204は返さない）
  • コンタクト自体は削除されず、案件との紐付けのみ削除される
Authorizations:
bearer_auth
path Parameters
deal_id
required
integer

案件ID

contact_id
required
integer

コンタクトID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

案件アクション(Actions)

案件アクション情報リスト

案件アクション一覧をカーソルページネーション形式で取得します。

  • レスポンスは v1 と同じ actions キーの配列を含む構造（{ actions, hasMore, nextCursor, totalCount }）
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

sort
string
Default: "-startDatetime"
Enum: "startDatetime" "-startDatetime" "start_datetime" "-start_datetime"

ソート順。- プレフィックスで降順。デフォルトは startDatetime 降順。ソート可能 startDatetime

startDatetime
string <date-time>

開始日時の下限フィルタ（以降）

endDatetime
string <date-time>

終了日時の上限フィルタ（以前）

createdAtFrom
string <date-time>

作成日時の下限フィルタ（以降）

createdAtTo
string <date-time>

作成日時の上限フィルタ（以前）

updatedAtFrom
string <date-time>

更新日時の下限フィルタ（以降）

updatedAtTo
string <date-time>

更新日時の上限フィルタ（以前）

users[][id]
Array of integers

担当者IDによる絞り込み（複数指定可）

purpose
integer

目的IDによる絞り込み

active
string
Enum: "true" "false"

ステータスによる絞り込み

dealId
integer

案件IDによる絞り込み

Responses

Response samples

Content type
application/json
{
  • "actions": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

案件アクション登録

案件アクションを新規登録します。

  • purpose、startDatetime、endDatetime、creator、deal は必須
Authorizations:
bearer_auth
Request Body schema: application/json
required
object

アクションの目的

startDatetime
required
string <date-time>

開始日時

endDatetime
required
string <date-time>

終了日時

required
object

アクション担当者ID

required
object

案件ID

Array of objects

他の担当者

Array of objects

アクションコンタクト

preNote
string or null

アクションの事前メモ

result
string or null

アクションの実施結果

active
boolean

アクションの状態(true=未完了、false=完了)

Array of objects

アクション詳細項目一覧

Responses

Request samples

Content type
application/json
{
  • "purpose": {
    },
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "creator": {
    },
  • "deal": {
    },
  • "invitees": [
    ],
  • "contacts": [
    ],
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "actionCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "string",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "deal": {
    },
  • "purpose": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

案件アクション情報

案件アクション詳細を取得します。

  • レスポンスはリソースオブジェクトを素で返します（dataラップなし）
  • include_files=1 を指定するとファイル添付情報（files）を含みます
Authorizations:
bearer_auth
path Parameters
id
required
integer

アクションID

query Parameters
include_files
string
Default: "0"
Enum: "0" "1"

1 を指定すると、添付ファイルの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "files": [
    ],
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "外部サービスなどから取り込んだ,\nアクションの実施結果",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "deal": {
    },
  • "purpose": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

案件アクション情報更新

案件アクションを更新します。

  • 指定したフィールドのみ更新します（部分更新）
  • invitees を指定した場合は全量置き換えになります
Authorizations:
bearer_auth
path Parameters
id
required
integer

アクションID

Request Body schema: application/json
object

アクションの目的

startDatetime
string <date-time>

開始日時

endDatetime
string <date-time>

終了日時

object

アクション担当者ID

preNote
string or null

アクションの事前メモ

result
string or null

アクションの実施結果

active
boolean

アクションの状態(true=未完了、false=完了)

Array of objects

他の担当者

Array of objects

アクションコンタクト

Array of objects

アクション詳細項目一覧

Responses

Request samples

Content type
application/json
{
  • "purpose": {
    },
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "creator": {
    },
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "invitees": [
    ],
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "string",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "deal": {
    },
  • "purpose": {
    },
  • "contacts": [
    ],
  • "actionCustoms": [
    ]
}

案件アクション情報削除

案件アクションを削除します。

  • 削除成功時はレスポンスボディなしで200を返す（v1同様。204は返さない）
Authorizations:
bearer_auth
path Parameters
id
required
integer

アクションID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

案件アクション一括登録

案件アクションを一括登録します（v1同様の同期実行）。

  • 成功時は作成したアクションIDの配列を返します
  • 処理はall-or-nothingで、1件でも失敗すると全件ロールバックされます
  • 1リクエストあたりの上限は 1000 件です。
Authorizations:
bearer_auth
Request Body schema: application/json
dealTypeId
required
integer

案件タイプID

required
Array of objects

登録するアクションの配列

Responses

Request samples

Content type
application/json
{
  • "dealTypeId": 0,
  • "actions": [
    ]
}

Response samples

Content type
application/json
[
  • 0
]

コンタクト(Contacts)

コンタクト情報リスト

コンタクト一覧をカーソルページネーション形式で取得します。

  • レスポンスは v1 同様に contacts キーの配列 ({ contacts, hasMore, nextCursor, totalCount })
  • v1 GET /api/v1/contacts と互換のあるフィルタを、v2 形式で提供します
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

searchWord
string

指定した文字列と取引先名、コンタクト名、またはメールアドレスが部分一致するコンタクトを検索します。

updatedAtFrom
string <date-time>
Example: updatedAtFrom=2018-04-01T10:30:00

更新日時による検索範囲(開始)

  • ex) 2018-04-01T10:30:00
updatedAtTo
string <date-time>
Example: updatedAtTo=2018-04-01T10:30:00

更新日時による検索範囲(終了)

  • ex) 2018-04-01T10:30:00
phoneNumber
string
Example: phoneNumber=03-1111-2222

固定電話番号、携帯電話番号による検索
ハイフン 市外局番 検索可能

  • ex) 03-1111-2222
  • ex) 0311112222
  • ex) 04992(0)1111
  • ex) 049920局1111
sort
string
Default: "-updated_at"
Enum: "updated_at" "-updated_at" "created_at" "-created_at" "updatedAt" "-updatedAt" "createdAt" "-createdAt"

並び順 ソート可能 updatedAt、createdAt （v2: - プレフィックスで降順。デフォルトは -updated_at）

itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 contactCustoms を item_key をキーにしたオブジェクト形式で返す

Responses

Response samples

Content type
application/json
{
  • "contacts": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

コンタクト情報登録

  • コンタクト情報を新規に登録します
  • 登録後のコンタクト情報をレスポンスとして返します
  • PAT 認証の場合のみ権限判定が実行されます
  • レスポンスは contactCustoms を常時含みます（compactCustoms相当。v2はnoCustoms/compactCustoms指定不可）
Authorizations:
bearer_auth
Request Body schema: application/json
required
name
required
string

コンタクト名

email
string or null

メールアドレス

tel
string or null

電話番号

mobileTel
string or null

携帯電話番号

address
string or null

住所

dept
string or null

部署

position
string or null

役職

memo
string or null

メモ

object or null

取引先

Array of objects

コンタクト詳細項目

Array of objects

ライフサイクルステージ

Array of objects

関連付けカスタムオブジェクト

  • 一度に登録可能な上限は1000件です

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "string",
  • "tel": "string",
  • "mobileTel": "string",
  • "address": "string",
  • "dept": "string",
  • "position": "string",
  • "memo": "string",
  • "customer": {
    },
  • "contactCustoms": [
    ],
  • "lifecycleStages": [
    ],
  • "customObjects": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "email": "string",
  • "tel": "string",
  • "mobileTel": "string",
  • "address": "string",
  • "dept": "string",
  • "position": "string",
  • "memo": "string",
  • "marketoLeadScore": 0,
  • "customer": {
    },
  • "contactCustoms": [
    ],
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00"
}

コンタクト情報検索

コンタクト情報を検索します。

  • field の reference (参照先関連オブジェクト) として以下を指定できます。
    • customer (取引先)
  • レスポンスはカーソルページネーション形式 ({ contacts, hasMore, nextCursor, totalCount })
  • contactCustoms は常時返却（compactCustoms=true相当で型別フィールドのみ。noCustoms/compactCustomsのクライアント指定は不可）
  • 検索は検索インデックスで実行されます。filter / sort に指定できる標準項目は検索インデックス収録のもの（各スキーマの説明を参照）に限られ、それ以外は 400 になります
  • 並び順は request body の sort で指定できます（例: name / updated_at / created_at）。省略時は updated_at 降順（id 昇順タイブレーク）
Authorizations:
bearer_auth
query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

Request Body schema: application/json
required
required
object (ContactSearchFilter)

絞り込み条件

  • compositeFilter と valueFilter を合わせて最大300個まで指定できます(最上位の compositeFilter は件数に含まれません)。
object (ContactSearchSort)

並び順。省略時は updated_at 降順（id 昇順タイブレーク）。 項目値が NULL のレコードは、昇順では先頭・降順では末尾に並びます。

Responses

Request samples

Content type
application/json
{
  • "filter": {
    },
  • "sort": {
    }
}

Response samples

Content type
application/json
{
  • "contacts": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

コンタクト情報

コンタクト詳細を取得します。

  • レスポンスはリソースオブジェクトを素で返します
  • include_related_objects=1 を指定するとカスタムオブジェクト連携情報（customObjects）を含みます
Authorizations:
bearer_auth
path Parameters
id
required
integer

コンタクトID

query Parameters
itemKeyAsPropertyKey
string
Enum: "true" "false"

true の場合 contactCustoms を item_key をキーにしたオブジェクト形式で返す

include_related_objects
integer
Default: 0

1 を指定すると、関連付けオブジェクトの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "email": "string",
  • "tel": "string",
  • "mobileTel": "string",
  • "address": "string",
  • "dept": "string",
  • "position": "string",
  • "memo": "string",
  • "marketoLeadScore": 0,
  • "customer": {
    },
  • "lifecycleStages": [
    ],
  • "contactCustoms": [
    ],
  • "customObjects": [
    ],
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00"
}

コンタクト情報更新

  • コンタクト情報を更新
  • PAT 認証の場合のみ権限判定が実行されます
  • レスポンスは contactCustoms を常時含みます（compactCustoms相当。v2はnoCustoms/compactCustoms指定不可）
  • 指定した属性のみ更新されます（部分更新）
  • レスポンスは v1 同様にリソースオブジェクトを素で返します（data ラップなし）。contactCustoms（詳細項目）も常時含めて返却します
Authorizations:
bearer_auth
path Parameters
id
required
integer

コンタクトID

Request Body schema: application/json
name
string

コンタクト名

email
string or null

メールアドレス

tel
string or null

電話番号

mobileTel
string or null

携帯電話番号

address
string or null

住所

dept
string or null

部署

position
string or null

役職

memo
string or null

メモ

object or null

取引先

Array of objects

コンタクト詳細項目

Array of objects

ライフサイクルステージ

Array of objects

関連付けカスタムオブジェクト

  • 一度に登録可能な上限は1000件です

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "email": "string",
  • "tel": "string",
  • "mobileTel": "string",
  • "address": "string",
  • "dept": "string",
  • "position": "string",
  • "memo": "string",
  • "customer": {
    },
  • "contactCustoms": [
    ],
  • "lifecycleStages": [
    ],
  • "customObjects": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "name": "string",
  • "email": "string",
  • "tel": "string",
  • "mobileTel": "string",
  • "address": "string",
  • "dept": "string",
  • "position": "string",
  • "memo": "string",
  • "marketoLeadScore": 0,
  • "customer": {
    },
  • "contactCustoms": [
    ],
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00"
}

コンタクト情報削除

  • コンタクト情報を削除
  • PAT 認証時のみ権限判定が実行されます
  • 関連する詳細項目・アクション・案件紐付けも同時に削除されます（物理削除のため復元できません）
Authorizations:
bearer_auth
path Parameters
id
required
integer

コンタクトID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

コンタクトアクション(ContactActions)

コンタクトアクション情報リスト

指定したコンタクトに紐づくアクション一覧をカーソルページネーション形式で取得します。

  • レスポンスは v1 と同じ actions キーの配列を含む構造（{ actions, hasMore, nextCursor, totalCount }）
  • dataType 未指定時はコンタクトアクション(1)・案件アクション(0)の両方を返します
Authorizations:
bearer_auth
path Parameters
contact_id
required
integer

コンタクトID

query Parameters
limit
integer [ 1 .. 1000 ]
Default: 100

取得件数（1〜1000、デフォルト100）

cursor
string

次ページ取得用カーソル。前回レスポンスの nextCursor をそのまま指定する

sort
string
Default: "-startDatetime"
Enum: "startDatetime" "-startDatetime" "start_datetime" "-start_datetime"

ソート順。- プレフィックスで降順。デフォルトは startDatetime 降順。ソート可能 startDatetime

dataType
integer
Enum: 0 1

アクション種別での絞り込み（0:案件アクション / 1:コンタクトアクション）。未指定時は両方

startDatetime
string <date-time>
Example: startDatetime=2018-04-01T10:30:00+09:00

開始日時の下限フィルタ（以降）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

endDatetime
string <date-time>
Example: endDatetime=2018-04-01T10:30:00+09:00

終了日時の上限フィルタ（以前）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

createdAtFrom
string <date-time>
Example: createdAtFrom=2018-04-01T10:30:00+09:00

作成日時の下限フィルタ（以降）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

createdAtTo
string <date-time>
Example: createdAtTo=2018-04-01T10:30:00+09:00

作成日時の上限フィルタ（以前）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

updatedAtFrom
string <date-time>
Example: updatedAtFrom=2018-04-01T10:30:00+09:00

更新日時の下限フィルタ（以降）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

updatedAtTo
string <date-time>
Example: updatedAtTo=2018-04-01T10:30:00+09:00

更新日時の上限フィルタ（以前）。タイムゾーンを明示すること（省略時はUTCとして解釈される）

users[][id]
Array of integers

担当者IDによる絞り込み（複数指定可）

pattern
integer

アクションパターンによる絞り込み

active
string
Enum: "true" "false"

ステータスによる絞り込み

Responses

Response samples

Content type
application/json
{
  • "actions": [
    ],
  • "hasMore": true,
  • "nextCursor": "string",
  • "totalCount": 0
}

コンタクトアクション登録

コンタクトアクションを登録します。

  • pattern / startDatetime / endDatetime / creator は必須です
  • レスポンスには actionCustoms（アクション詳細）を常に含めます
  • 日時は JST (+09:00) で返します
Authorizations:
bearer_auth
path Parameters
contact_id
required
integer

コンタクトID

Request Body schema: application/json
required
startDatetime
required
string <date-time>

開始日時

endDatetime
required
string <date-time>

終了日時

required
object

アクション担当者ID

Array of objects

他の担当者

preNote
string

アクションの事前メモ

result
string

アクションの実施結果

active
boolean

アクションの状態(true=未完了、false=完了)

required
object
Array of objects

アクション詳細項目一覧

Array of objects

アクションに紐付ける他のコンタクト

Responses

Request samples

Content type
application/json
{
  • "startDatetime": "2018-04-01T10:30:00+09:00",
  • "endDatetime": "2018-04-01T10:30:00+09:00",
  • "creator": {
    },
  • "invitees": [
    ],
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "pattern": {
    },
  • "actionCustoms": [
    ],
  • "contacts": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "dataType": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "外部サービスなどから取り込んだ,\nアクションの実施結果",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "contact": {
    },
  • "deal": {
    },
  • "actionCustoms": [
    ]
}

コンタクトアクション情報

コンタクトアクション詳細を取得します。

  • レスポンスはリソースオブジェクトを素で返します（dataラップなし）
  • include_files=1 を指定するとファイル添付情報（files）を含みます
Authorizations:
bearer_auth
path Parameters
contact_id
required
integer

コンタクトID

id
required
integer

アクションID

query Parameters
include_files
string
Default: "0"
Enum: "0" "1"

1 を指定すると、添付ファイルの情報を含めて返します。

Responses

Response samples

Content type
application/json
{
  • "files": [
    ],
  • "id": 0,
  • "dataType": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "外部サービスなどから取り込んだ,\nアクションの実施結果",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "contact": {
    },
  • "deal": {
    },
  • "actionCustoms": [
    ]
}

コンタクトアクション情報更新

コンタクトアクション情報を更新します。

  • 指定したフィールドのみ更新します（部分更新）
  • 更新後のレスポンスには actionCustoms（アクション詳細）を常に含めます
Authorizations:
bearer_auth
path Parameters
contact_id
required
integer

コンタクトID

id
required
integer

アクションID

Request Body schema: application/json
startDatetime
string <date-time>

開始日時

endDatetime
string <date-time>

終了日時

object

アクション担当者ID

Array of objects

他の担当者

preNote
string

アクションの事前メモ

result
string

アクションの実施結果

active
boolean

アクションの状態(true=未完了、false=完了)

object
Array of objects

アクション詳細項目一覧

Responses

Request samples

Content type
application/json
{
  • "startDatetime": "2018-04-01T10:30:00+09:00",
  • "endDatetime": "2018-04-01T10:30:00+09:00",
  • "creator": {
    },
  • "invitees": [
    ],
  • "preNote": "string",
  • "result": "string",
  • "active": true,
  • "pattern": {
    },
  • "actionCustoms": [
    ]
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "dataType": 0,
  • "startDatetime": "2019-08-24T14:15:22Z",
  • "endDatetime": "2019-08-24T14:15:22Z",
  • "active": true,
  • "syncCalendar": true,
  • "createdAt": "2018-04-01T10:30:00+09:00",
  • "updatedAt": "2018-04-01T10:30:00+09:00",
  • "preNote": "string",
  • "result": "string",
  • "extraResult": "外部サービスなどから取り込んだ,\nアクションの実施結果",
  • "pattern": {
    },
  • "creator": {
    },
  • "invitees": [
    ],
  • "contact": {
    },
  • "deal": {
    },
  • "actionCustoms": [
    ]
}

コンタクトアクション情報削除

コンタクトアクションを削除します。

  • 削除成功時はレスポンスボディなしで 200 を返す（v1同様。204は返さない）
Authorizations:
bearer_auth
path Parameters
contact_id
required
integer

コンタクトID

id
required
integer

アクションID

Responses

Response samples

Content type
application/json
{
  • "error": "The access token is invalid."
}

コンタクトアクション一括登録

コンタクトアクションを一括登録します。

  • v1 と同様に同期実行し、作成されたアクションIDの配列を返します。
  • 1リクエストあたりの上限は1000件です。
  • 1件でもエラーがある場合は全件ロールバックします。
Authorizations:
bearer_auth
Request Body schema: application/json
required
Array of objects <= 1000 items

登録するコンタクトアクション一覧

Responses

Request samples

Content type
application/json
{
  • "actions": [
    ]
}

Response samples

Content type
application/json
[
  • 0
]