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

# Configurar webhook do GitHub

> Registra a credencial do GitHub e cria a URL que recebe eventos.

Registra a credencial do GitHub e cria a URL que recebe eventos. O token embutido na URL expira após uma hora. Para automação contínua via workflow, use [GitHub Actions](https://docs.dscloud.pt/getstarted/github-action.md).

## Parâmetros

**appId** `string` *required*

ID da aplicação, obtido no painel ou em `response.applications[].id` ao [consultar a conta](https://docs.dscloud.pt/api-reference/endpoint/users/me.md).

**access\_token** `string` *required*

Token do GitHub para acesso ao repositório. Guarde-o em um gerenciador de segredos.

## Resposta

HTTP 200. `response` é um objeto. Seus campos também podem aparecer no nível superior por compatibilidade.

```json HTTP 200 theme={null}
{
  "status": "success",
  "code": "SUCCESS",
  "response": {
    "webhook": "https://api.dscloud.pt/v3/git/webhook/SEGREDO"
  },
  "webhook": "https://api.dscloud.pt/v3/git/webhook/SEGREDO",
  "success": true
}
```

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 400 | `MISSING_ACCESS_TOKEN` | Credencial ausente. |
| 401 | `INVALID_GITHUB_TOKEN` | Credencial recusada pelo GitHub. |


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