# Customize Invoice Logo and Colors

Update the business brand settings for e-invoicing. Sets the logo URL and primary/secondary brand colors that appear on generated invoices.

## API Endpoint

`POST /api/v1/e-invoicing/customize-invoice`

### Authorization

**In:** `header`

`Authorization: Bearer <token>`

### Request Body

```json
{
  "logo_url": "string",
  "primary_color": "string",
  "secondary_color": "string|null"
}
```

- **logo_url**: URL of the business logo
- **primary_color**: Primary brand color as hex code
- **secondary_color**: Secondary brand color as hex code (optional)

### Response Body

#### 200 Success Response

```json
{
  "requestId": "string",
  "requestTimestamp": "string",
  "message": "string",
  "statusCode": 200,
  "data": {
    "logo_url": "string",
    "primary_color": "string",
    "secondary_color": "string"
  }
}
```

#### Example Response for 200

```json
{
  "requestId": "3a6538fd-03f0-4b05-ba41-5d44769dd014",
  "requestTimestamp": "2026-04-09 12:00:00",
  "message": "Business brand updated successfully.",
  "statusCode": 200,
  "data": {
    "logo_url": "https://example.com/logo.png",
    "primary_color": "#1A73E8",
    "secondary_color": "#FF5722"
  }
}
```

#### 401 Unauthorized Response

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-04-09 12:00:00",
  "message": "Unauthenticated.",
  "statusCode": 401
}
```

#### 422 Unprocessable Entity Response

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-04-09 12:00:00",
  "message": "The logo url field is required.",
  "statusCode": 422,
  "errors": {}
}
```

#### 500 Internal Server Error Response

```json
{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2026-04-09 12:00:00",
  "message": "An error occurred while processing your request.",
  "statusCode": 500
}
```

---

**How is this guide?**  
Good / Bad

Last updated on 5/27/2026