---
title: "Service: /members/{member}/externaluris [POST]"
source: https://dev.pageseeder.com/api/services/create-externaluri_post.html
description: "Creates an external URI (URL) accessible to all server members. Requires contributor permissions. Accepts URL and optional metadata like title, description, labels, mediatype, and size. Returns XML with created URI details."
last_updated: 2026-09-08T13:57:12+10:00
document_type: api_endpoint
operation_id: uri-POST
resource_id: uri
path_template: /members/{member}/externaluris
http_method: POST
api_category: uri
implementation_version: 6.2004
api_since: 5.9900
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~343
---

# /members/\{member\}/externaluris \[POST\]

## Description

Create an external URI (aka URL). The URI and it's properties are available to all members on the server.

> **Note:** All parameters except url are ignored if the user does not have permission to edit all URLs on the server. In this case or if a parameter is empty the value will be extracted from the URL source according to the URL type template.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| url | The URL | yes | url |  |
| description | The description | no | string |  |
| labels | A comma-separated list of label values | no | string |  |
| mediatype | The mediatype | no | string |  |
| size | The size in bytes | no | long |  |
| title | The title | no | string |  |
| type | The URL type | no | string |  |

## Permission

This service requires contributor or higher.

## Response

The output has the following format:

```xml

<uri-creation>
  <uri id="[id]" path="[path]" ...>
    <displaytitle>[title]</displaytitle>
    ...
  </uri>
</uri-creation>
```

## Error Handling

| Code | Cause / Description |
| --- | --- |
| 0x1211 | Existing URI |
| 0x1212 | Invalid URL |
| 0x1226 | Domain is not allowed for this URL type |
| 0x1227 | Media type is not allowed for this URL type |
| 0x6202 | Failed to load URL config file for this URL type |