---
title: "corestack_company_update"
url: https://docs.corefinity.com/mcp/tools/corestack_company_update
type: tool
last_updated: 2026-11-13
feature: organisation
related:
  - https://docs.corefinity.com/api/reference/organisation/update-company-settings.md
  - https://docs.corefinity.com/guides/organisation/people/organisations.md
---
# corestack_company_update

**Change your company's settings.** Change your company's alert preferences and which Slack channel each kind of alert goes to. Anything you leave out stays as it is. Scope: write.

- Scope: `write`
- Runs as a task: no

## When to use it

Change your company's alert preferences and which Slack channel each kind of alert goes to, as My Company lets your
company's users do. Anything you leave out stays as it is. A channel is `#name` of the connected Slack workspace; null
means none (for `deployment_started`: the same channel as deployments). This is `PUT /api/company`. The name, phone
number and address are changed by Corefinity; connecting Slack and requiring two-factor sign-in are done in the
Control Panel.

## Inputs

- `deployment_started_notifications` (boolean): post to Slack when a deployment starts.
- `alerts_notifications` (boolean): monitoring alerts by email and SMS.
- `slack_channels` (object): any of `deployments`, `deployment_started`, `tickets`, `maintenance_windows`, `alerts`, each `#name` or null.

### Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "alerts_notifications": {
      "description": "Monitoring alerts by email and SMS.",
      "type": "boolean"
    },
    "deployment_started_notifications": {
      "description": "Post to Slack when a deployment starts.",
      "type": "boolean"
    },
    "slack_channels": {
      "additionalProperties": false,
      "description": "A channel of your Slack workspace (#name) per kind of alert; null for none (for deployment_started: the deployments channel).",
      "properties": {
        "alerts": {
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "deployment_started": {
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "deployments": {
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "maintenance_windows": {
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        },
        "tickets": {
          "maxLength": 255,
          "type": [
            "string",
            "null"
          ]
        }
      },
      "type": "object"
    }
  },
  "type": "object"
}
```

## Refusals

- `not_connected`: your company has not connected Slack, so no channel can be chosen.
- `invalid_arguments`: a channel the workspace does not have (on `slack_channels.<kind>`), nothing to change, or Slack could not list channels (on `slack_channels`). In the last case check the Slack connection and try again; existing settings stay unchanged.
- The refusals every tool can answer: `invalid_arguments`, `tenant_mismatch`, `scope_required`, `pin_refused`, `rate_limited`, `temporarily_unavailable`, `internal_error` (corestack://guides/how-this-server-works).

## Example

```json
{
  "name": "corestack_company_update",
  "arguments": {
    "deployment_started_notifications": true,
    "slack_channels": {
      "deployments": "#deployments"
    }
  }
}
```

## Prompt

```text
Using the Corefinity MCP server, call corestack_company_update with deployment_started_notifications true, slack_channels {"deployments":"#deployments"}. (Change your company's settings.) Tell me what it returned.
```

## The same task elsewhere

- Endpoint: [PUT /api/company](https://docs.corefinity.com/api/reference/organisation/update-company-settings.md)
- Guide: [Organisations](https://docs.corefinity.com/guides/organisation/people/organisations.md)
