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

# NSRelationAgent

> Contact/Person relations.

Contact/Person relations.

## Constructors

### NSRelationAgent()

```crmscript theme={null}
NSRelationAgent
```

Contact/Person relations.

## Methods

## CreateDefaultContactRelationEntity()

Sets default values into a new NSContactRelationEntity.

```crmscript theme={null}
NSContactRelationEntity CreateDefaultContactRelationEntity()
```

**Returns:** [CRMScript.NetServer.NSContactRelationEntity](CRMScript.NetServer.NSContactRelationEntity)

<Note>
  NetServer calculates default values (for example, Country) on the entity, which is required when creating/storing a new instance
</Note>

**Example:**

```crmscript theme={null}
NSRelationAgent agent;
NSContactRelationEntity thing = agent.CreateDefaultContactRelationEntity();
thing = agent.SaveContactRelationEntity(thing);
```

## DeleteContactRelation(Integer)

Deletes the specified contact relation.

```crmscript theme={null}
Void DeleteContactRelation(Integer contactRelationEntityId)
```

**Returns:** [CRMScript.Global.Void](CRMScript.Global.Void)

## GetContactRelationEntity(Integer)

Gets an NSContactRelationEntity object.

```crmscript theme={null}
NSContactRelationEntity GetContactRelationEntity(Integer contactRelationEntityId)
```

**Returns:** [CRMScript.NetServer.NSContactRelationEntity](CRMScript.NetServer.NSContactRelationEntity)

**Example:**

```crmscript theme={null}
NSRelationAgent agent;
NSContactRelationEntity thing = agent.GetContactRelationEntity(123);
```

## SaveContactRelation(NSContactRelationEntity)

Creates a new or updates an existing contact relation.

```crmscript theme={null}
NSContactRelationEntity SaveContactRelation(NSContactRelationEntity contactRelationEntity)
```

**Returns:** [CRMScript.NetServer.NSContactRelationEntity](CRMScript.NetServer.NSContactRelationEntity)

**Example:**

```crmscript theme={null}
NSRelationAgent agent;
NSContactRelationEntity contactRelationEntity;
NSContactRelationEntity res = agent.SaveContactRelation(contactRelationEntity);
```


## Related topics

- [SuperOffice.WebApi.Agents.RelationAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.RelationAgent.md)
- [SuperOffice.WebApi.Agents.IRelationAgent](/en/api/reference/webapi/SuperOffice.WebApi.Agents.IRelationAgent.md)
- [Relation](/en/api/archive-providers/reference/relation.md)
- [Relations](/en/api/reference/restful/rest/person/relations.md)
- [Relation rules](/en/request/admin/relation-rules.md)