Consents

The client.Consents sub-client manages recipient consent records. Consent tracking allows you to comply with regulations such as GDPR, LGPD, and TCPA by recording whether a recipient has opted in or out of receiving communications on a specific channel or for a specific application and notification type.

When a message is processed, the platform checks the consent status for the recipient. If the recipient has not consented (or has explicitly opted out), the message is placed in the NotConsented state and not sent.

Available methods

Consent model

ConsentResponse fields:

Scoping fields are optional. A consent record without a scope applies broadly. A record with ChannelTypeId scoped to SMS applies only to SMS messages for that recipient.

Creating a consent record

using OneSend2U.Sdk.Consents.Models;

var consent = await client.Consents.CreateAsync(new CreateConsentRequest
{
    Recipient   = "+15550001234",
    IsConsented = true,
    ChannelTypeId             = smsChannelTypeId,
    ApplicationId             = billingApplicationId,
    DeploymentEnvironmentId   = productionEnvironmentId
});

Console.WriteLine($"Consent created: {consent.Id}");
Console.WriteLine($"Consented: {consent.IsConsented}");

To record an opt-out, set IsConsented = false:

var optOut = await client.Consents.CreateAsync(new CreateConsentRequest
{
    Recipient   = "+15550001234",
    IsConsented = false,
    ChannelTypeId = smsChannelTypeId
});

Listing consents

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

Console.WriteLine($"Total: {list.TotalCount}");
foreach (var consent in list.Items)
    Console.WriteLine($"{consent.Recipient} — Consented: {consent.IsConsented}");

Getting a consent by ID

var consent = await client.Consents.GetAsync(consentId);
Console.WriteLine($"Recipient: {consent.Recipient}");
Console.WriteLine($"Consented: {consent.IsConsented}");

Getting a consent with navigation properties

Returns the consent record along with its related country, application, channel type, and environment lookups.

var details = await client.Consents.GetWithDetailsAsync(consentId);

Updating a consent record

Use this to change the consent status (e.g., when a recipient opts out via a preference center).

var existing = await client.Consents.GetAsync(consentId);

await client.Consents.UpdateAsync(consentId, new UpdateConsentRequest
{
    Recipient             = existing.Recipient,
    IsConsented           = false,   // opt-out
    ChannelTypeId         = existing.ChannelTypeId,
    ApplicationId         = existing.ApplicationId,
    DeploymentEnvironmentId = existing.DeploymentEnvironmentId,
    ConcurrencyStamp      = existing.ConcurrencyStamp
});

Deleting a consent record

await client.Consents.DeleteAsync(consentId);
Console.WriteLine("Consent record deleted.");

Regulatory compliance notes

• GDPR (EU): Requires a lawful basis for processing personal data. Explicit consent is one basis. Record and retain consent timestamps.
• LGPD (Brazil): Similar to GDPR — explicit consent required for marketing communications.
• TCPA (US): Prior express written consent required for automated SMS and calls to mobile numbers.

The OneSend2U consent system records and enforces opt-in/opt-out at the platform level. Always consult your legal team for jurisdiction-specific requirements.