# Create Trusted By metadata

URL: /en/docs/api/v1/trusted-by/post
Last Updated: 2026-07-30T21:15:44.972Z

## Description
No description available.

## Available Actions
- Execute POST request
- View request parameters
- View response schema
- Get code examples
- Navigate to related topics
- View step-by-step instructions
- Get best practices

## Content
### POST /api/v1/trusted-by

**Create Trusted By metadata**

Create a Trusted By entry. Badge uploads are performed separately via `/api/v1/trusted-by/{id}/badge`.

**Authentication:** Bearer token (`Authorization: Bearer <token>`)

**Request body** (`application/json`) - required:

- `title` (string): Optional customer or brand display name
- `url` (string (uri)): Optional HTTP(S) URL for the logo card
- `order` (integer): Optional display order. Lower values appear first.
- `hasBadge` (boolean): Set to true when the entry will immediately receive a badge upload.

Example (new_customer):

```json
{
  "title": "Acme Corp",
  "url": "https://acme.example.com",
  "order": 10
}
```

**Responses:**

- `201` - Trusted By metadata created
  - `success` (boolean)
  - `data` (object)
    - `id` (string): Newly created Trusted By ID
    - `uploadUrls` (object)
      - `badge` (string): Endpoint to upload a badge asset

  Example (created):
  
  ```json
  {
  "success": true,
  "data": {
    "id": "customer-789",
    "uploadUrls": {
      "badge": "/api/v1/trusted-by/customer-789/badge"
    }
  }
}
  ```
- `400` - Validation error
  - `error` (string, required): Machine-readable error code
  - `details` (string): Human-readable error details

  Example (invalid_url):
  
  ```json
  {
  "error": "url_invalid"
}
  ```

  Example (missing_identity):
  
  ```json
  {
  "error": "trusted_by_identity_required"
}
  ```
- `401` - Unauthorized
  - `error` (string, required): Machine-readable error code
  - `details` (string): Human-readable error details
- `403` - Forbidden - insufficient permissions to create Trusted By entries
  - `error` (string, required): Machine-readable error code
  - `details` (string): Human-readable error details
- `409` - Conflict - Trusted By entry could not be created due to a conflicting state
  - `error` (string, required): Machine-readable error code
  - `details` (string): Human-readable error details
- `500` - Internal server error
  - `error` (string, required): Machine-readable error code
  - `details` (string): Human-readable error details