# Create Media

[View original](https://ittybit.com/api/media/create)


`POST /media`

Creates a new media item. See [Media Object](/docs/media) for more details.

### Request Body

The request body should contain a properly formatted JSON object with one or more of `title`, `alt`, or `metadata` properties. See [Media Object](/docs/media) for more details.

**Schema:**

```json
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "alt": {
      "type": "string"
    },
    "metadata": {
      "type": "object"
    }
  }
}
```

**Example:**

```json
{
  "title": "My Video Example",
  "alt": "An example video used to demonstrate the ittybit API",
  "metadata": {
    "customKey2": "a different custom value"
  }
}
```

### Responses

#### 201 - Success

**Example:**

```json
{
  "meta": {
    "request_id": "req_abcdefghij1234567890",
    "org_id": "org_abcdefgh1234",
    "project_id": "prj_abcdefgh1234",
    "version": "2025-01-01",
    "type": "object"
  },
  "data": {
    "id": "med_abcdefgh1234",
    "object": "media",
    "kind": null,
    "title": "My Video Example",
    "alt": "An example video used to demonstrate the ittybit API",
    "files": [],
    "urls": {},
    "background": null,
    "metadata": {
      "customKey": "your custom value"
    },
    "created": "2025-01-01T01:23:45Z",
    "updated": "2025-01-01T01:23:45Z"
  },
  "error": null,
  "links": {
    "self": "https://api.ittybit.com/media/med_abcdefgh1234",
    "parent": "https://api.ittybit.com/media"
  }
}
```