# AWS Systems Manager Incident Manager Contacts API

> AWS Systems Manager Incident Manager Contacts API on Apizie: 39 endpoints (Used to acknowledge an engagement to a contact channel during an incident., Activates a contact's contact channel. Incident Manager can't engage a contact until the contact channel has…, Contacts are either the contacts that Incident Manager engages during an incident or the escalation plans…, A contact channel is the method that Incident Manager uses to engage your contact., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-ssm-contacts`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-ssm-contacts
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-ssm-contacts/openapi.json

Systems Manager Incident Manager is an incident management console designed to help users mitigate and recover from incidents affecting their Amazon Web Services-hosted applications. An incident is any unplanned…

## Endpoints

### Used to acknowledge an engagement to a contact channel during an incident.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/accept-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Activates a contact's contact channel. Incident Manager can't engage a contact until the contact channel has…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/activate-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Contacts are either the contacts that Incident Manager engages during an incident or the escalation plans…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/create-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### A contact channel is the method that Incident Manager uses to engage your contact.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/create-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a rotation in an on-call schedule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/create-rotation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates an override for a rotation in an on-call schedule.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/create-rotation-override` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### To no longer receive Incident Manager engagements to a contact channel, you can deactivate the channel.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/deactivate-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### To remove a contact from Incident Manager, you can delete the contact. Deleting a contact removes them from…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/delete-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### To no longer receive engagements on a contact channel, you can delete the channel from a contact. Deleting…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/delete-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a rotation from the system. If a rotation belongs to more than one on-call schedule, this operation…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/delete-rotation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes an existing override for an on-call rotation.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/delete-rotation-override` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Incident Manager uses engagements to engage contacts and escalation plans during an incident. Use this…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/describe-engagement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists details of the engagement to a contact channel.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/describe-page` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves information about the specified contact or escalation plan.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/get-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### List details about a specific contact channel.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/get-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the resource policies attached to the specified contact or escalation plan.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/get-contact-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves information about an on-call rotation.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/get-rotation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves information about an override to an on-call rotation.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/get-rotation-override` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists all contact channels for the specified contact.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-contact-channels` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists all contacts and escalation plans in Incident Manager.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-contacts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists all engagements that have happened in an incident.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-engagements` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists all of the engagements to contact channels that have been acknowledged.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-page-receipts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns the resolution path of an engagement. For example, the escalation plan engaged in an incident might…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-page-resolutions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the engagements to a contact's contact channels.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-pages-by-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the engagements to contact channels that occurred by engaging a contact.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-pages-by-engagement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of shifts based on rotation configuration parameters. The Incident Manager primarily uses…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-preview-rotation-shifts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Retrieves a list of overrides currently specified for an on-call rotation.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-rotation-overrides` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of shifts generated by an existing rotation in the system.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-rotation-shifts` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Retrieves a list of on-call rotations.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-rotations` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| MaxResults | integer | no | Pagination limit |
| NextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the tags of an escalation plan or contact.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Adds a resource policy to the specified contact or escalation plan. The resource policy is used to share the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/put-contact-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Sends an activation code to a contact channel. The contact can use this code to activate the contact channel…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/send-activation-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts an engagement to a contact or escalation plan. The engagement engages each contact specified in the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/start-engagement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Stops an engagement before it finishes the final stage of the escalation plan or engagement plan. Further…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/stop-engagement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Tags a contact or escalation plan. You can tag only contacts and escalation plans in the first region of…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Removes tags from the specified resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the contact or escalation plan specified.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/update-contact` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates a contact's contact channel.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/update-contact-channel` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the information specified for an on-call rotation.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/update-rotation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/accept-page" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS Systems Manager Incident Manager Contacts API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-ssm-contacts/accept-page with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS Systems Manager Incident Manager Contacts API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS Systems Manager Incident Manager Contacts itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS Systems Manager Incident Manager Contacts API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-ssm-contacts.

### What is the status of the AWS Systems Manager Incident Manager Contacts API?
Needs your own provider key (bring your own key)
