> ## 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 Record

Create a new contract record with the specified metadata properties.

**Required OAuth scope:** `public.records.createRecords`

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Ironclad documentation](https://developer.ironcladapp.com/reference/create-a-record).

## Basic Parameters

| Parameter | Description |
| - | - |
| Children | The records to set as the child records of the created record, as a JSON array of objects containing the record IDs or Ironclad IDs. **For example:** <pre>`[  {    "recordId": "17009e0d-z2e9-425d-a85b-1cf152773e49"  }]`</pre> |
| Links | The records to link to the created record, as a JSON array of objects containing the record IDs or Ironclad IDs. **For example:** <pre>`[  {    "recordId": "17009e0d-z2e9-425d-a85b-1cf152773e49"  }]`</pre> |
| Name | The name of the record. |
| Parent Link Type | Select the type of relationship the record has with its parent. |
| Parent Record ID | The ID or Ironclad ID of the record to set as the parent of the created record. You can get record IDs using the `List Records` action. |
| Properties | The metadata properties to attach to the record, as a JSON object of property IDs and their typed values. You can get the available record properties using the `List Records Metadata` action. **For example:** <pre>`{  "counterpartyName": {    "type": "string",    "value": "Test LLC"  },  "agreementDate": {    "type": "date",    "value": "2018-05-08T00:00:00-07:00"  }}`</pre> |
| Type | The type of the record. You can get the available record types using the `List Records Metadata` action. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Address As Object | Select to return address properties as objects instead of strings. |
| Properties To Amend | The properties to amend from the created amendment record to its parent, as a JSON object of property IDs and their amendment behavior. **Note**: Only valid when `Parent Link Type` is `amendment`. **For example:** <pre>`{  "contractValue": {    "amendmentType": "replace"  }}`</pre> |

## Example Output

```json theme={"dark"}
{
	"id": "string",
	"ironcladId": "string",
	"type": "string",
	"typeDisplayName": "string",
	"name": "string",
	"lastUpdated": "string",
	"properties": {},
	"attachments": {},
	"links": [
		{
			"recordId": "string"
		}
	],
	"parentId": "string",
	"parentLinkType": "string",
	"childIds": [
		"string"
	],
	"contractStatus": {
		"status": "string",
		"enhancedStatus": "string",
		"remainingDuration": "string",
		"eventDate": "string",
		"message": "string"
	},
	"source": {},
	"amendments": [
		"string"
	]
}
```

## Workflow Library Example

[Create Record with Ironclad and Send Results Via Email](https://library.blinkops.com/workflows/create-record-with-ironclad-and-send-results-via-email)

![Workflow Library](https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max\&auto=format\&n=ojHYuDeYX5FWuN8a\&q=85\&s=b8af968e71438a9499c3223c9bd29fb2)

Preview this Workflow on desktop

[https://library.blinkops.com/workflows/create-record-with-ironclad-and-send-results-via-email/canvas](https://library.blinkops.com/workflows/create-record-with-ironclad-and-send-results-via-email/canvas)