---
title: "Update Fiscal Entity"
method: PUT
path: "/customers/{id}/fiscal_entities/{fiscal_entities_id}"
tags: ["Customers"]
---

# Update Fiscal Entity

`PUT /customers/{id}/fiscal_entities/{fiscal_entities_id}`

## Request

- Base URL: `https://api.conekta.io`
- URL: `https://api.conekta.io/customers/{id}/fiscal_entities/{fiscal_entities_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/conekta/apis/conekta-api/docs/customers/:id/fiscal_entities/:fiscal_entities_id/put.ts> (a function with typed inputs; its response is checked against the schema)

Update Fiscal Entity resource that corresponds to a customer ID.

## Path parameters

- `id` string, required
- `fiscal_entities_id` string, required

## Headers

- `Accept-Language` 'es' | 'en'
- `X-Child-Company-Id` string

## Request body

- UpdateFiscalEntityRequest
  - `address` FiscalEntityRequestAddress
    - `street1` string, required
    - `street2` string
    - `postal_code` string, required
    - `city` string, required
    - `state` string
    - `country` string: this field follows the [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
    - `external_number` string
  - `tax_id` string
  - `email` string
  - `phone` string
  - `metadata` object
  - `company_name` string

## Response `200`

successful operation

- UpdateCustomerFiscalEntitiesResponse
  - `address` FiscalEntityRequestAddress, required
    - `street1` string, required
    - `street2` string
    - `postal_code` string, required
    - `city` string, required
    - `state` string
    - `country` string: this field follows the [ISO 3166-1 alpha-2 standard](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
    - `external_number` string
  - `tax_id` string
  - `email` string
  - `phone` string
  - `metadata` object
  - `company_name` string
  - `id` string, required
  - `object` string, required
  - `created_at` integer, required
  - `parent_id` string
  - `default` boolean

## Other responses

- `401`: authentication error
- `404`: not found entity
- `422`: parameter validation error
- `500`: internal server error

## Changes

- **2026-11-03** `52f4c0dd8a1b`: 2 breaking, 2 warning
  - the `metadata` request property type changed from no type to `object`
  - the `allOf[subschema #1: fiscal_entity_request]/metadata` response's property type changed from no type to `object` for status `200`
  - removed the request property `address/allOf[subschema #1]/residential`
  - removed the optional property `allOf[subschema #1: fiscal_entity_request]/address/allOf[subschema #1]/residential` from the response with the `200` status

[Operation history](https://skmtc.dev/conekta/apis/conekta-api/changes/customers/:id/fiscal_entities/:fiscal_entities_id/put.md)

---

[API](https://skmtc.dev/conekta/apis/conekta-api.md) - [All operations](https://skmtc.dev/conekta/apis/conekta-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conekta/apis/conekta-api/revisions/52f4c0dd8a1b?raw)