---
title: 'Set foreign code'
url: 'https://documentation.netstorming.net/customers-handling-api/set-foreign-code'
markdown: 'https://documentation.netstorming.net/customers-handling-api/set-foreign-code.md'
date: '2026-11-10'
description: 'URI: /api/customers/setForeignCode REQUEST: { "key": "Loremipsumdolorsitametconsecteturadipiscingelitlaoreet", "owner_code": "netstorming", "code": "test_cust1", "user_login": "usr01", "foreign_code": "ext_001_t1" } Request parameters: Key Compulsory Value type Max length Notes key…'
taxonomy:
  category:
    - docs
---

# Set foreign code

[](#)  [ Customers Handling API ](https://documentation.netstorming.net/customers-handling-api)      Set foreign code    

##### URI:

`/api/customers/setForeignCode`

##### REQUEST:

```
{
  "key": "Loremipsumdolorsitametconsecteturadipiscingelitlaoreet",
  "owner_code": "netstorming",
  "code": "test_cust1",
  "user_login": "usr01",
  "foreign_code": "ext_001_t1"
}
```

Request parameters:

| Key | Compulsory | Value type | Max length | Notes |
|---|---|---|---|---|
| key | yes | varchar |  | API Key provided by Netstorming |
| owner\_code | yes | varchar | 3-12 alphanumeric chars | Owner the requested customers belongs to |
| code | yes | varchar | 3-12 alphanumeric chars | Customer code in Netstorming system |
| user\_login | yes | varchar | 3-12 alphanumeric chars | User login in Netstorming system |
| foreign\_code | yes | varchar |  | [Foreign code](https://documentation.netstorming.net/single-sign-on/foreign-code) |

##### RESPONSE:

```
{
    "success": true
}
```

Response parameters:

| Key | Compulsory | Value type | Notes |
|---|---|---|---|
| success | yes | bool |  |

 [ ](https://documentation.netstorming.net/customers-handling-api/customer-insert) [](https://documentation.netstorming.net/customers-handling-api/customer-enable-disable)

---

## Navigation

- Parent: [Customers Handling API](https://documentation.netstorming.net/customers-handling-api.md)
- Previous: [Customer insert](https://documentation.netstorming.net/customers-handling-api/customer-insert.md)
- Next: [Enable or disable customers](https://documentation.netstorming.net/customers-handling-api/customer-enable-disable.md)