---
title: "POST /responder-gateway/{gatewayId}/certificate"
method: POST
path: "/responder-gateway/{gatewayId}/certificate"
---

# POST /responder-gateway/{gatewayId}/certificate

`POST /responder-gateway/{gatewayId}/certificate`

Associates an ACM certificate with a responder gateway.

## Path parameters

- `gatewayId` string, required

## Request body

- object
  - `acmCertificateArn` string, required — The Amazon Resource Name (ARN) of the ACM certificate to associate.
  - `clientToken` string, required — <p>Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a <a href="https://wikipedia.org/wiki/Universally_unique_identifier">UUID type of value</a>.</p> <p>If you don't provide this value, then Amazon Web Services generates a random one for you.</p> <p>If you retry the operation with the same <code>ClientToken</code>, but with different parameters, the retry fails with an <code>IdempotentParameterMismatch</code> error.</p>

## Response `200`

Success

- AssociateCertificateResponse
  - `gatewayId` string, required — The unique identifier of the gateway.
  - `acmCertificateArn` string, required — The Amazon Resource Name (ARN) of the ACM certificate.
  - `status` 'PENDING_ASSOCIATION' | 'ASSOCIATED' | 'PENDING_DISASSOCIATION' | 'DISASSOCIATED' | 'FAILED', required — The status of the certificate association.

## Other responses

- `480` — ServiceQuotaExceededException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — ConflictException
- `485` — InternalServerException
- `486` — ValidationException

---

[API](https://skmtc.net/aws/apis/rtbfabric.md) · [All operations](https://skmtc.net/aws/apis/rtbfabric/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rtbfabric/versions/9fa17cecba3a/schema)