> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amply-app.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lister et enregistrer des webhooks avec l’API REST

> Créez et gérez les webhooks via l’API REST Amply. Enregistrez les URL qui recevront les notifications lorsque les contenus du projet changent.

La ressource Webhooks permet d’enregistrer et de gérer les points de terminaison de vos webhooks par programmation. Vous pouvez l’utiliser dans le parcours de configuration d’une intégration, par exemple pour enregistrer automatiquement une URL de réception lorsqu’un utilisateur installe votre application.

<Note>
  Pour comprendre les types d’événements, le contenu des notifications et la vérification des signatures, consultez le [guide des webhooks](/analytics/webhooks).
</Note>

## Points de terminaison

| Méthode | Chemin | Description |
| - | - | - |
| `GET` | `/webhooks` | Lister les webhooks enregistrés |
| `POST` | `/webhooks` | Enregistrer un webhook |

***

## GET /webhooks — Lister les webhooks

Renvoie les points de terminaison des webhooks enregistrés dans le projet.

### Exemple de requête

```bash theme={null}
curl https://api.amply-app.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Exemple de réponse

```json theme={null}
{
  "data": [
    {
      "id": "wh_ghi789",
      "url": "https://my-server.com/amply-hook",
      "events": ["event.created", "article.published"],
      "active": true,
      "created_at": "2024-05-10T14:00:00Z"
    }
  ]
}
```

***

## POST /webhooks — Créer un webhook

Enregistre un webhook. Amply envoie ensuite une requête HTTP `POST` à l’URL choisie lorsqu’un des événements suivis se produit.

### Paramètres du corps

<ParamField body="url" type="string" required>
  URL HTTPS complète à laquelle Amply doit envoyer les notifications, par exemple `https://my-server.com/amply-hook`.
</ParamField>

<ParamField body="events" type="array" required>
  Tableau des types d’événements à suivre. Exemples : `event.created`, `event.updated`, `event.deleted`, `article.published`, `place.created`.
</ParamField>

<ParamField body="secret" type="string">
  Secret facultatif utilisé pour signer les notifications avec HMAC. S’il est renseigné, Amply ajoute un en-tête `X-Amply-Signature` à chaque envoi pour vous permettre de vérifier son authenticité. Le secret est renvoyé uniquement dans la réponse à cette requête et ne peut pas être récupéré ensuite.
</ParamField>

### Exemple de requête

```bash theme={null}
curl -X POST https://api.amply-app.com/v1/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://my-server.com/amply-hook",
    "events": ["event.created", "article.published"],
    "secret": "my-webhook-secret"
  }'
```

<Tip>
  Conservez le secret de votre webhook comme un mot de passe. Il est renvoyé une seule fois, dans la réponse à cette requête `POST`. Si vous le perdez, supprimez le webhook et créez-en un nouveau avec un autre secret.
</Tip>


## Related topics

- [Relier Amply à vos outils avec les webhooks](/analytics/webhooks.md)
- [Gérer vos contenus avec l’API REST Amply](/api-reference/introduction.md)
- [Gérer les événements et les séances avec l’API REST](/api-reference/events.md)
- [Automatiser des tâches avec Amply Pro](/analytics/automations.md)
- [Gérer les articles du blog avec l’API REST Amply](/api-reference/articles.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.