---
title: "Create AWS Integration"
method: POST
path: "/v1/integrate/clouds/aws"
tags: ["IoT Integrator"]
---

# Create AWS Integration

`POST /v1/integrate/clouds/aws`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/clouds/aws`
- Auth: HTTP bearer

Creates AWS Integration, which becomes active only after customer Cloudformation stack is rolled out.

## Request body

- Postschema7: Post AWS integration request
  - `name` string, required: Name of the new AWS integration.
  - `eventTypes` Postschema7EventTypesInner[], required: A list of event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string: Version of the event type, if not provided latest version will be used
  - `jsonPayloadEnabled` boolean: Flag if the payloads of this integration should be bridged in JSON format.

## Response `201`

Created AWS Integration Details.

- PostResponseschema5: Post AWS integration response
  - `name` string, required: Name of the new AWS integration.
  - `eventTypes` PostResponseschema5EventTypesInner[], required: A list of event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string, required: Version of the event type
  - `state` 'ROLLOUT_STARTED' | 'ROLLOUT_DONE' | 'ROLLOUT_FAILED' | 'INTEGRATION_ACTIVE' | 'INTEGRATION_FAILED', required: State of the new AWS integration.
  - `type` 'AWS', required: Type of the new integration.
  - `id` string, required: ID of the new AWS integration.
  - `jwt` string, required: JWT token with details for integration stack creation
  - `createdTime` string, date-time, required: Created timestamp of the AWS integration.
  - `updatedTime` string, date-time, required: Updated timestamp of the AWS integration.
  - `jsonPayloadEnabled` boolean, required: Flag if the payloads of this integration should be bridged in JSON format.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)