---
updatedAt: 2026-04-21T16:11:36.000Z
agentTools:
  projectIndex: https://apidoc.factorialhr.com/llms.txt
---

# Teams > Team > Updates

Subscription_type: `teams/team/update`

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Factorial API",
    "description": "",
    "version": "2026-10-01"
  },
  "webhooks": {
    "Webhooks > Teams > Team > Updates": {
      "post": {
        "tags": [
          "Webhooks"
        ],
        "description": "Subscription_type: `teams/team/update`",
        "deprecated": false,
        "summary": "Teams > Team > Updates",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Return a 200 status to indicate that the data was received successfully"
          }
        },
        "requestBody": {
          "description": "Callback payload",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/teams_team"
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "proxy-enabled": false
  },
  "servers": [
    {
      "url": "https://api.factorialhr.com",
      "description": "Production server"
    },
    {
      "url": "https://api.demo.factorial.dev",
      "description": "Demo server (deprecated)"
    },
    {
      "url": "https://api.eu2.demo.factorial.dev",
      "description": "Demo server"
    }
  ],
  "security": [
    {
      "oauth2": []
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "https://id.factorialhr.com/oauth/authorize",
            "tokenUrl": "https://id.factorialhr.com/api/oauth/token",
            "refreshUrl": "https://id.factorialhr.com/api/oauth/token",
            "scopes": {
              "read": "Required for all operations",
              "write": "Required for write operations",
              "approvals": "Access to approvals",
              "banking": "Access to banking",
              "company_holidays": "Access to company holidays",
              "company_legal_entities": "Access to company legal entities",
              "company_locations": "Access to company locations",
              "compensations": "Access to compensations",
              "contracts": "Access to contracts",
              "custom_fields": "Access to custom fields",
              "documents": "Access to documents",
              "employee_updates": "Access to employee updates",
              "employees": "Access to employees",
              "expenses": "Access to expenses",
              "finance": "Access to finance",
              "integrations": "Access to integrations",
              "it_management": "Access to it management",
              "job_catalog": "Access to job catalog",
              "marketplace": "Access to marketplace",
              "payroll": "Access to payroll",
              "payroll_supplements": "Access to payroll supplements",
              "performance": "Access to performance",
              "posts": "Access to posts",
              "processes": "Access to processes",
              "project_management_expenses": "Access to project management expenses",
              "project_management_projects": "Access to project management projects",
              "project_management_time": "Access to project management time",
              "recruitment": "Access to recruitment",
              "shift_management": "Access to shift management",
              "tasks": "Access to tasks",
              "time_off": "Access to time off",
              "time_tracking": "Access to time tracking",
              "trainings": "Access to trainings"
            }
          }
        }
      }
    },
    "schemas": {
      "teams_team": {
        "type": "object",
        "required": [
          "id",
          "name",
          "company_id"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the team",
            "example": "1"
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the team (e.g. \"Engineering\")",
            "example": "Engineering"
          },
          "description": {
            "type": "string",
            "description": "Free-text description of the team",
            "example": "Engineering team description"
          },
          "avatar": {
            "type": "string",
            "description": "URL of the team's avatar image (null when the team has none)",
            "example": "https://api.factorialhr.com/rails/active_storage/representations/redirect/team.png"
          },
          "employee_ids": {
            "type": "array",
            "description": "IDs of the employees who are members of this team",
            "example": [
              "10",
              "12"
            ],
            "items": {
              "type": "string"
            }
          },
          "lead_ids": {
            "type": "array",
            "description": "IDs of the employees who are leads of this team (subset of employee_ids)",
            "example": [
              "10"
            ],
            "items": {
              "type": "string"
            }
          },
          "company_id": {
            "type": "string",
            "description": "ID of the company this team belongs to",
            "example": "1"
          },
          "depth": {
            "type": "integer",
            "description": "Depth of this team in the nested-team hierarchy: 1 for a top-level team, 2 for its children, and so on. Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.",
            "example": 2
          },
          "parent_team_id": {
            "type": "string",
            "description": "ID of the parent team this team is nested under (null for a root team). Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.",
            "example": "5"
          }
        }
      }
    }
  }
}
```