Contacts

The SDK provides two sub-clients for managing contacts and contact groups:

• client.Contacts — individual contact records
• client.ContactsGroups — groups that organize contacts

Contacts

Available methods

Contact model

ContactResponse fields:

Creating a contact

Name and Email are required.

using OneSend2U.Sdk.Contacts.Models;

var contact = await client.Contacts.CreateAsync(new CreateContactRequest
{
    Name    = "Jane",
    Surname = "Doe",
    Email   = "jane.doe@example.com",
    Phone   = "+15550001234"
});

Console.WriteLine($"Created contact: {contact.Id} — {contact.DisplayName}");

Listing contacts

var list = await client.Contacts.GetListAsync(new GetContactsRequest
{
    SkipCount      = 0,
    MaxResultCount = 50
});

Console.WriteLine($"Total: {list.TotalCount}");
foreach (var contact in list.Items)
    Console.WriteLine($"{contact.Id} — {contact.DisplayName} — {contact.Email}");

Getting a contact by ID

var contact = await client.Contacts.GetAsync(contactId);
Console.WriteLine($"Name: {contact.DisplayName}");
Console.WriteLine($"Phone: {contact.Phone}");

Updating a contact

Pass the ConcurrencyStamp from the GetAsync response to enable optimistic concurrency:

var existing = await client.Contacts.GetAsync(contactId);

await client.Contacts.UpdateAsync(contactId, new UpdateContactRequest
{
    Name             = existing.Name,
    Surname          = existing.Surname,
    Email            = "new.email@example.com",
    Phone            = existing.Phone,
    ConcurrencyStamp = existing.ConcurrencyStamp
});

Deleting a contact

await client.Contacts.DeleteAsync(contactId);
Console.WriteLine("Contact deleted.");

Contacts Groups

Available methods

Creating a contact group

using OneSend2U.Sdk.ContactsGroups.Models;

var group = await client.ContactsGroups.CreateAsync(new CreateContactsGroupRequest
{
    Name        = "Newsletter Subscribers",
    Code        = "NEWSLTTR",   // unique per tenant, max 10 chars
    Description = "Opted-in customers for the monthly newsletter",
    ContactIds  = [contactId1, contactId2]
});

Console.WriteLine($"Group created: {group.Id} — {group.Name} ({group.Code})");

Listing contact groups

var list = await client.ContactsGroups.GetListAsync(new GetContactsGroupsRequest
{
    SkipCount      = 0,
    MaxResultCount = 20
});

foreach (var group in list.Items)
    Console.WriteLine($"{group.Id} — {group.Name} ({group.Code})");

Getting a group with members

var details = await client.ContactsGroups.GetWithDetailsAsync(groupId);

// details.ContactsGroup holds the group itself; details.Contacts is the member list
Console.WriteLine($"Group: {details.ContactsGroup?.Name}");
foreach (var contact in details.Contacts ?? [])
    Console.WriteLine($"  Member: {contact.DisplayName}");

Updating a contact group

var existing = await client.ContactsGroups.GetAsync(groupId);

await client.ContactsGroups.UpdateAsync(groupId, new UpdateContactsGroupRequest
{
    Name             = existing.Name,
    Code             = existing.Code,
    Description      = "Updated description",
    ContactIds       = [contactId1, contactId2, contactId3],
    ConcurrencyStamp = existing.ConcurrencyStamp
});

Deleting a contact group

await client.ContactsGroups.DeleteAsync(groupId);
Console.WriteLine("Group deleted.");