---
updatedAt: 2026-07-24T08:27:13.000Z
agentTools:
  projectIndex: https://docs.fire.com/llms.txt
---

# Update account configuration

This endpoint changes the name associated with an account. You will need to enable PERM_BUSINESS_PUT_ACCOUNT to use this endpoint.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Fire Financial Services Business API",
    "description": "The fire.com API allows you to deeply integrate Business Account features into your application or back-office systems.\n",
    "version": "1.0",
    "contact": {
      "name": "Fire API",
      "url": "https://docs.fire.com",
      "email": "api@fire.com"
    }
  },
  "servers": [
    {
      "url": "https://api.fire.com/business",
      "description": "Production Server"
    }
  ],
  "paths": {
    "/v2/accounts/{ican}": {
      "put": {
        "summary": "Update account configuration",
        "description": "This endpoint changes the name associated with an account. You will need to enable PERM_BUSINESS_PUT_ACCOUNT to use this endpoint.",
        "tags": [
          "Accounts"
        ],
        "operationId": "updateAccountConfig",
        "parameters": [
          {
            "in": "path",
            "required": true,
            "name": "ican",
            "schema": {
              "type": "string",
              "description": "The unique id for the account",
              "example": "12345"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "description": "The name the account name should be changed to",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccountConfiguration"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "The account was updated."
          },
          "400": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiErrorV2"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiErrorV2"
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "An error has occured. Any 403 errors usually mean your access token is invalid or missing. For other errors, check the validity of your input, and if you are permitted to access this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "title": "apiErrors",
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ApiErrorV2"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "webhook": {
      "post": {
        "summary": "Event Webhook",
        "tags": [
          "Webhooks"
        ],
        "description": "Webhooks allow you to be notified of events as they happen on your Fire accounts. The below sample response shows how a webhook from Fire will arrive at your server. See our 'Webhooks' guide for more detailed information.",
        "requestBody": {
          "required": true,
          "content": {
            "application/jwt": {
              "schema": {
                "type": "string",
                "example": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "A 200 response is required from your server. Returns a 200 response to indicate that the data was received successfully."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Access Token"
      }
    },
    "schemas": {
      "AccountConfiguration": {
        "title": "accountConfiguration",
        "type": "object",
        "properties": {
          "accountName": {
            "type": "string",
            "description": "This is the name the account will be updated to.",
            "example": "John Doe"
          }
        }
      },
      "ApiErrorV2": {
        "title": "apiError",
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int64",
            "description": "Error Code",
            "example": 50051
          },
          "message": {
            "type": "string",
            "description": "The error message",
            "example": "Sorry, we are unable to proceed with your request."
          }
        }
      }
    }
  },
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Accounts",
      "description": "Fire accounts are the equivalent of a bank account from bank."
    },
    {
      "name": "Webhooks",
      "description": "Events you can receive in realtime"
    }
  ]
}
```