Skip to main content

​
Methods

​
Update

func (s *ContactsSvcImpl) Update(params *UpdateContactRequest) (UpdateContactResponse, error)
Updates an existing contact.

​
UpdateWithContext

func (s *ContactsSvcImpl) UpdateWithContext(ctx context.Context, params *UpdateContactRequest) (UpdateContactResponse, error)
Updates an existing contact with context support.

​
Request Parameters

​
UpdateContactRequest

​
id
string
required
The contact ID to update. Either id or email is required.
​
email
string
The contact’s new email address, or use this to identify the contact instead of id
​
audience_id
string
Deprecated: Optional - Omit for global contacts. Use Segments API for contact organization.
​
first_name
string
The contact’s first name
​
last_name
string
The contact’s last name
​
unsubscribed
bool
Whether the contact is unsubscribed. Use SetUnsubscribed() method to set this value (see examples).
​
properties
map[string]any
Custom key-value pairs for global contacts (when audience_id is omitted).Important: Currently, the Resend API only accepts string values for properties. Non-string values will be rejected.Example: map[string]any{"tier": "premium", "age": "30"}

​
SetUnsubscribed Method

func (r *UpdateContactRequest) SetUnsubscribed(val bool)
Sets the unsubscribed status. This is a temporary helper method for backwards compatibility (will be improved in v3). Use this method to explicitly set the unsubscribed field to false, since the default zero value for bool is false with omitempty.

​
Response

​
UpdateContactResponse

​
data
Contact
The updated contact object containing:
  • id (string): Contact identifier
  • email (string): Email address
  • object (string): Object type
  • first_name (string): First name
  • last_name (string): Last name
  • created_at (string): Creation timestamp
  • unsubscribed (bool): Unsubscribe status
  • properties (map[string]any): Custom properties
​
error
struct{}
Error information if the update failed

​
Examples

​
Update Contact Name

package main

import (
    "fmt"
    "github.com/resend/resend-go/v2"
)

func main() {
    client := resend.NewClient("re_123456789")

    params := &resend.UpdateContactRequest{
        Id:        "c1a2b3c4-d5e6-7f8g-9h0i-1j2k3l4m5n6o",
        FirstName: "Jane",
        LastName:  "Smith",
    }

    response, err := client.Contacts.Update(params)
    if err != nil {
        panic(err)
    }

    fmt.Println("Updated:", response.Data.Email)
}

​
Update Using Email Address

params := &resend.UpdateContactRequest{
    Email:     "[email protected]",
    FirstName: "John",
}

response, err := client.Contacts.Update(params)

​
Update Unsubscribe Status

params := &resend.UpdateContactRequest{
    Id: "c1a2b3c4-d5e6-7f8g-9h0i-1j2k3l4m5n6o",
}
params.SetUnsubscribed(true)

response, err := client.Contacts.Update(params)
if err != nil {
    panic(err)
}

fmt.Println("Unsubscribed:", response.Data.Unsubscribed)

​
Update Contact Properties

params := &resend.UpdateContactRequest{
    Id: "c1a2b3c4-d5e6-7f8g-9h0i-1j2k3l4m5n6o",
    Properties: map[string]any{
        "tier":        "enterprise",
        "plan_updated": "2024-03-01",
    },
}

response, err := client.Contacts.Update(params)

​
Complete Update with Context

ctx := context.Background()

params := &resend.UpdateContactRequest{
    Id:        "c1a2b3c4-d5e6-7f8g-9h0i-1j2k3l4m5n6o",
    Email:     "[email protected]",
    FirstName: "Alice",
    LastName:  "Johnson",
    Properties: map[string]any{
        "company": "Acme Corp",
        "role":    "Developer",
    },
}
params.SetUnsubscribed(false)

response, err := client.Contacts.UpdateWithContext(ctx, params)
if err != nil {
    panic(err)
}

fmt.Println("Contact updated successfully")

​
Notes

  • Either Id or Email must be provided to identify the contact
  • Use SetUnsubscribed() method to set the unsubscribed status
  • Properties are only supported for global contacts (without audience_id)
  • The API currently only accepts string values for properties

Build docs developers (and LLMs) love

Get started for freeTalk to us