About this API
Update contact details (name/status) for a contact within a group for the authenticated user
Authentication
Include your API credential in the request header. Keep credentials on the server and never expose them in client-side applications.
Authorization: Bearer <TOKEN>YOUR_ACCESS_TOKENPath Parameters
Substitute these placeholders in the endpoint URL before sending the request.
groupIdstringRequiredResource identifier for groupId.contactIdstringRequiredResource identifier for contactId.Request Body
Send a application/json payload. Replace placeholder values with data from your integration.
Top-Level Fields
statusstringNot specifiedUpdated subscription status (e.g., subscribed, unsubscribed, bounced).last_namestringNot specifiedUpdated last name of the contact.first_namestringNot specifiedUpdated first name of the contact.{}
{
"type": "object",
"properties": {
"status": {
"type": "string",
"nullable": true,
"description": "Updated subscription status (e.g., subscribed, unsubscribed, bounced)."
},
"last_name": {
"type": "string",
"nullable": true,
"description": "Updated last name of the contact."
},
"first_name": {
"type": "string",
"nullable": true,
"description": "Updated first name of the contact."
}
}
}
Code Examples
Select your language and customize the request URL. Credential placeholders are intentionally preserved so secrets never appear in generated samples.
curl --request PUT 'https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}' \
--header 'Authorization: Bearer <TOKEN>' \
--header 'Content-Type: application/json' \
--data '{}'
const response = await fetch('https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}', {
method: 'PUT',
headers: {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
},
body: JSON.stringify({})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
const response = await fetch('https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}', {
method: 'PUT',
headers: {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
},
body: JSON.stringify({})
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
import json
import requests
url = 'https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}'
headers = {
"Authorization": "Bearer <TOKEN>",
"Content-Type": "application/json"
}
payload = json.loads(r'''{}''')
response = requests.put(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var client = HttpClient.newHttpClient();
String body = """
{}
""";
var request = HttpRequest.newBuilder(URI.create("https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}"))
.header("Authorization", "Bearer <TOKEN>")
.header("Content-Type", "application/json")
.method("PUT", HttpRequest.BodyPublishers.ofString(body))
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
<?php
$curl = curl_init();
$payload = '{}';
curl_setopt_array($curl, [
CURLOPT_URL => 'https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'PUT',
CURLOPT_HTTPHEADER => ["Authorization: Bearer <TOKEN>","Content-Type: application/json"],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($curl);
if ($response === false) throw new Exception(curl_error($curl));
curl_close($curl);
echo $response;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = AuthenticationHeaderValue.Parse("Bearer <TOKEN>");
var json = """
{}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PutAsync("https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}", content);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
"bytes"
)
func main() {
request, err := http.NewRequest("PUT", "https://email.1spoc.com/api/user/groups/{groupId}/contacts/{contactId}", bytes.NewBufferString("{}"))
if err != nil { panic(err) }
request.Header.Set("Content-Type", "application/json")
request.Header.Set("Accept", "application/json")
request.Header.Set("Authorization", "Bearer <TOKEN>")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
if response.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data)) }
fmt.Println(string(data))
}
Response
A successful request returns the documented response payload. Delivery and asynchronous events may arrive separately through configured webhooks.
{}
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email"
},
"status": {
"type": "string"
},
"added_at": {
"type": "string",
"format": "date-time"
},
"group_id": {
"type": "string",
"format": "uuid"
},
"last_name": {
"type": "string",
"nullable": true
},
"contact_id": {
"type": "string",
"format": "uuid"
},
"first_name": {
"type": "string",
"nullable": true
}
}
}
Status Codes
200Contact within the group updated successfully.400Missing group id or contact id.401Unauthorized (missing or invalid user access token)404Contact not found in this group.500Internal server error