**Source URL:** https://limited.veevavault.dev/vault-api/api-reference/23.1/binders/binder-relationships/create-binder-relationship.md

# Create Binder Relationship



<Endpoint path="/api/{version}/objects/binders/{binder_id}/versions/{major_version}/{minor_version}/relationships" method="POST"></Endpoint>

## Headers {#headers}

<FieldTable>
| Name | Description |
| --- | --- |
| `Content-Type` | `application/x-www-form-urlencoded` |
| `Accept` | `application/json` (default) or `application/xml` |
</FieldTable>

## URI Path Parameters {#uri-path-parameters}

<FieldTable>
| Name | Description |
| --- | --- |
| `{binder_id}` | The binder `id` field value. |
| `{major_version}` | The binder `major_version_number__v` field value. |
| `{minor_version}` | The binder `minor_version_number__v` field value. |
</FieldTable>

## Body Parameters {#body-parameters}

## Request {#request}

<CodeExample title="">
```
curl -X POST -H "Authorization: {SESSION_ID}" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "target_doc_id__v=13" \
-d "relationship_type__v=supporting_documents__c" \
-d "target_major_version__v=0" \
-d "target_minor_version__v=1" \
https://myvault.veevavault.com/api/v15.0/objects/binders/566/versions/0/3/relationships

```
</CodeExample>

## Response {#response}

<CodeExample title="">
```
{
    "responseStatus": "SUCCESS",
    "responseMessage": "Document relationship successfully created.",
    "id": 202
}

```
</CodeExample>

---

**Previous:** [Retrieve Binder Relationship](/vault-api/api-reference/23.1/binders/binder-relationships/retrieve-binder-relationship)  
**Next:** [Delete Binder Relationship](/vault-api/api-reference/23.1/binders/binder-relationships/delete-binder-relationship)