# uploadItemFromUrl

Mutation

Enqueue a single UGC URL for import into the current workspace.

Available to agents as MCP tool `uploadItemFromUrl` — see [Write tools](/api/v2/docs/mcp/write-tools#upload-item-from-url).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `input` | [`UploadItemFromUrlInput!`](/api/v2/docs/types/upload-item-from-url-input) | Yes | — | Mutation input. |

## Returns

| Name | Type | Description |
| --- | --- | --- |
| `success` | `Boolean!` | True when the URL was accepted (audit rows created and SocialBridge enqueued). False on validation failure. |
| `userErrors` | [`[UserError!]!`](/api/v2/docs/types/user-error) | List of user-facing validation errors. Empty on success. |

## Examples

### Upload an item from a URL

Enqueue a single UGC URL for import into the workspace.

```graphql
mutation UploadItemFromUrlDefault($input: UploadItemFromUrlInput!) {
  uploadItemFromUrl(input: $input) {
    success
    userErrors {
      field
      message
    }
  }
}
```

Variables:

```json
{
  "input": {
    "url": "https://www.instagram.com/p/docs-upload-sample/"
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "uploadItemFromUrl": {
      "success": true,
      "userErrors": []
    }
  }
}
```