Contacts

Manage contact lists and contacts as account operations on the client.

Group	Methods
Contacts	`ListContactLists`, `CreateContactList`, `ListContacts`, `AddContact`, `GetContact`, `UpdateContact`, `DeleteContact`, `AddContactPhone`, `DeleteContactPhone`, `ExportContacts` (CSV bytes), `ImportContactsCSV`, `GetGoogleContactsStatus`, `GoogleContactsSync`, `GoogleContactsDisconnect`

Lists


lists, err := client.ListContactLists(ctx)
 
newList, err := client.CreateContactList(ctx, sendafrica.CreateContactListRequest{
    Name: "VIP customers",
})

Contacts


contacts, err := client.ListContacts(ctx, sendafrica.ContactQuery{
    ContactListID: newList.ID,
    Page:          1,
    PerPage:       25,
})
 
contact, err := client.AddContact(ctx, sendafrica.AddContactRequest{
    ContactListID: newList.ID,
    FirstName:     "Ali",
    LastName:      "Mkwawa",
    Phone:         "0712345678", // normalized automatically
})
 
err = client.UpdateContact(ctx, contact.ID, sendafrica.UpdateContactRequest{
    FirstName: "Ali J.",
})
 
err = client.AddContactPhone(ctx, contact.ID, "0765432109")
err = client.DeleteContact(ctx, contact.ID)

Import & export


csvBytes, err := client.ExportContacts(ctx, sendafrica.ContactQuery{
    ContactListID: newList.ID,
})
 
err = client.ImportContactsCSV(ctx, sendafrica.ImportContactsCSVRequest{
    ContactListID:  newList.ID,
    ContentBase64:  base64.StdEncoding.EncodeToString(csvBytes),
    HasHeaderRow:   true,
})

Contacts feed the Campaigns feature — build a list once, blast to it on a schedule.