# Mutations / Webhooks

# Webhooks

**Mutation**
## activateWebhook — Returns [Webhook](/documentation/Objects/Webhook#Webhook)

**Scopes required:** edit_webhooks

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the webhook to activate |

**Example Mutation**

```graphql
mutation ActivateWebhook($id: ID!) {
    activateWebhook(id: $id) {
        id,
        name,
        active,
        url,
        events
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Mutation**
## deactivateWebhook — Returns [Webhook](/documentation/Objects/Webhook#Webhook)

**Scopes required:** edit_webhooks

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the webhook to deactivate |

**Example Mutation**

```graphql
mutation DeactivateWebhook($id: ID!) {
    deactivateWebhook(id: $id) {
        id,
        name,
        active,
        url,
        events
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Mutation**
## regenerateWebhookSignature — Returns [Webhook](/documentation/Objects/Webhook#Webhook)

**Scopes required:** edit_webhooks

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the webhook to regenerate the signature of |

**Example Mutation**

```graphql
mutation RegenerateWebhookSignature($id: ID!) {
    regenerateWebhookSignature(id: $id) {
        id,
        name,
        active,
        url,
        events
    }
}

# Example variables
{
    "id": "<ID>"
}
```

**Mutation**
## registerWebhook — Returns [Webhook](/documentation/Objects/Webhook#Webhook)

**Scopes required:** create_webhooks

| Arguments | Type | Description |
| --- | --- | --- |
| name | *String!* | The name of the webhook |
| url | *String!* | The URL to call when an event is fired |
| events | [[WebhookEventEnum!]](/documentation/Enums/Webhook-Event-Enum#WebhookEventEnum) | The events for this webhook to listen to |

**Example Mutation**

```graphql
mutation RegisterWebhook($name: String!, $url: String!) {
    registerWebhook(name: $name, url: $url) {
        id,
        name,
        active,
        url,
        events
    }
}

# Example variables
{
    "name": "<NAME>",
    "url": "<URL>"
}
```

**Mutation**
## removeWebhook — Returns [Webhook](/documentation/Objects/Webhook#Webhook)

**Scopes required:** delete_webhooks

| Arguments | Type | Description |
| --- | --- | --- |
| id | [ID!](/documentation/Types/UUID#UUID) | The ID of the webhook to remove |

**Example Mutation**

```graphql
mutation RemoveWebhook($id: ID!) {
    removeWebhook(id: $id) {
        id,
        name,
        active,
        url,
        events
    }
}

# Example variables
{
    "id": "<ID>"
}
```