Articles on: Notifications (Legacy)

Enable IAM Authentication for Webhooks

Plans: Premium, Enterprise Platforms: All platforms


Overview


AWS API service allows developers to create, maintain, publish, and monitor APIs. AfterShip supports AWS API gateway with IAM (Identity and access management) authentication as a webhook receiver. IAM authentication is a secure way of receiving webhook requests. It ensures that other members and entities have an appropriate level of access to critical resources.


Enable IAM authentication


  1. Get IAM User Access Key and Secret key
  2. Encode special characters in the URL as shown below


  1. Assemble encoded values as per below-mentioned format


`

https://webhooks.aftership.com/aftership/aws-api-gatway/v1?url=(AWS API Gateway URL)&access_key=(Access key ID)&secret_key=(Secret access key)

`


Copy the URL so created


  1. Paste URL > Save changes


Additional notes


  • AfterShip doesn't send the webhooks under the whitelist IPs for the AWS IAM Authentication webhook receiver gateway.
  • We need to verify the AWS gateway endpoint format because of the security and cost reason. We don't support custom domains as of now.

Updated on: 25/05/2026