## Set up webhook in Atlan

URL: https://docs.atlan.com/product/capabilities/build-apps/sdks/python/events/how-tos/aws-lambda/setup-webhook

> Set up webhooks in Atlan to trigger AWS Lambda functions for event-driven integrations using the Python SDK (pyatlan).

# Set up webhook in Atlan

## Create Atlan webhook

Now all you need to do is set up the webhook in Atlan, to call your AWS Lambda function URL.

:::warning[You need to complete the other steps first]
It's important you complete the other steps in this section first (setting up the AWS Lambda function). You won't be able to save the webhook in Atlan without it verifying the target for the webhook, so the AWS Lambda function must be running and able to correctly validate the test payload *before* setting up the webhook in Atlan.
:::
Assuming you have completed those steps first, you should then be able to [create the webhook in Atlan](https://ask.atlan.com/hc/en-us/articles/7145739770511)—for the *Webhook URL* enter the AWS Lambda's function URL:

 ## Add signing secret to AWS Lambda

During the final step of setting up the webhook, you will be shown a **Secrety Key**. Copy this value for use in your AWS Lambda function to verify incoming requests are actually coming from Atlan.

> *Oops, I forgot to copy it. How do I get a new one? — see full content on the documentation site.*

To assign the key in your AWS Lambda function:

1. Open the [AWS Lambda functions console](https://console.aws.amazon.com/lambda/home#/functions).
2. From the list of *Functions*, click your AWS Lambda function.
3. Change to the **Configuration** tab.
4. From the left, click **Environment variables**.
5. In the upper-right of the *Environment variables* table, click the **Edit** button.
6. Paste the secret key from Atlan as the *Value* for the `SIGNING_SECRET` environment variable. (Create one, if you didn't create one earlier.)
7. In the lower-right, click the **Save** button.

:::warning[Required to process events]
When using the SDKs to handle events using these steps, the signing key is ***required***. Every request will validate the signing key before attempting any processing, so if you:

- haven't set up the signing key, or
- are using the wrong signing key, or
- generated a new signing key and forgot to update this environment variable in the AWS Lambda function

Then the AWS Lambda function will reject every event it's sent.[^1]
:::
[^1]: Except for the verification request when setting up the webhook in Atlan—that single event is unsigned.

---