> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Or Update IP Address

Create or update an IP address.

<Note>
  External Documentation

  To learn more, visit the [Device 42 documentation](https://api.device42.com/#!/IPAM/postIPAM_ips).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter         | Description                                                                                                                                                                                                                                                        |
  | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Device IDs        | A comma-separated list of device IDs to attach to the created/updated IP address.                                                                                                                                                                                  |
  | Devices           | A comma-separated list of device names to attach to the created/updated IP address.                                                                                                                                                                                |
  | IP Address        | The IP to create or update. <br /><br />**Note:** If a matching IP address is found, it will update the first matched IP address unless you specify a `VRF Group` or `VRF Group ID`, then it matches or adds the IP to that VRF group).                            |
  | Label             | The label to attach to the created/updated IP address. Use `d42_null` to clear up the content of the IP label.                                                                                                                                                     |
  | Locked            | Select `yes` to lock the `IP-to-device` mapping for the specified `devices` or `device_ids`. Select `no` to unlock it.<br /><br />**Note:** If no devices are provided, no action is taken. For new IP-to-device mappings, this value defaults to `no` (unlocked). |
  | MAC Address       | The MAC address to attach to the created/updated IP address to.                                                                                                                                                                                                    |
  | Remove Device IDs | A comma-separated list of device IDs to remove from to the updated IP address.                                                                                                                                                                                     |
  | Remove Devices    | A comma-separated list of device names to remove from the updated IP address.                                                                                                                                                                                      |
  | Subnet            | The name of the subnet to attach the created/updated IP address to. **Note:** Must be unique.                                                                                                                                                                      |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter      | Description                                                                                                                                              |
  | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Available      | Select whether to mark the IP address as available.                                                                                                      |
  | Clear All      | Select `yes` to mark the IP address as available. This action will clear all associated fields, including `device`, `MAC address`, `notes`, and `label`. |
  | Notes          | Additional notes to add to the created/updated IP address.                                                                                               |
  | Tags           | A comma-separated list of tags to attach to the updated/created IP address.                                                                              |
  | Type           | The type to filter the results by.                                                                                                                       |
  | VRF Group ID   | The ID of the VRF group to associate the IP address with.                                                                                                |
  | VRF Group Name | The name of the group to associate the IP address with.                                                                                                  |
</div>

## Example Output

```json theme={"dark"}
{
	"msg": [
		"ip added or updated'76'192.168.1.1",
		true,
		false
	],
	"code": 0
}
```

## Workflow Library Example

[Create or Update Ip Address with Device 42 and Send Results Via Email](https://library.blinkops.com/workflows/create-or-update-ip-address-with-device-42-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-or-update-ip-address-with-device-42-and-send-results-via-email/canvas" />
</div>