Endpoint
| field | value |
|---|
| method | POST |
| path | /api/integrations/v1/campaigns |
| operationId | create_integration_campaign_api_integrations_v1_campaigns_post |
| auth | server to server integration client token |
| Idempotency-Key | required |
| lifecycle | stable |
| resource type | campaign |
| data classification | internal |
| scope risk | medium |
| write operation | yes |
Summary
Create Integration Campaign
Required scope
| scope | requirement |
|---|
| campaigns:write | required |
Operation contract
| field | value |
|---|
| bulk mode | - |
| bulk max items | - |
| bulk dry run | - |
| sync type | - |
| sync max limit | - |
| reconciliation | - |
Path parameters
Query parameters
Header parameters
| name | required | schema |
|---|
| Idempotency-Key | required | string |
Request body
| status | media type | schema |
|---|
| - | application/json | IntegrationCampaignCreate |
Response
| status | media type | schema |
|---|
| 201 | application/json | CampaignOut |
Example
curl -X POST "https://api.marketing.anshin.care/api/integrations/v1/campaigns" \
-H "Authorization: Bearer $ANSHIN_MARKETING_INTEGRATION_ACCESS_TOKEN" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"example":"replace with request schema"}'
業務境界
- domain: キャンペーン
- endpoint は各 backend の S2S scoped OpenAPI artifact から同期しています。
- company 境界は backend で検証します。
- write 系 endpoint は、画面用 API と endpoint を分け、処理本体は service 層で共通化します。