contact_information:delete

Status: 📅 Planned - Coming Soon

Description

This mutation message will delete a single contact information record by its ID. Contact information includes emails, phone numbers, websites, and other ways to reach people, households, or organizations.

Expected Functionality

When implemented, this mutation will:

• Delete a contact information record by ID
• Remove it from any associated records (person, household, organization)
• Return a message_id for async processing

Expected Request Schema

{
  "payload": {
    "type": "contact_information:delete",
    "id": 123
  },
  "signature": "payload_ed25519_hex_signature",
  "source_public_key": "your_client_public_key"
}

Request Attributes

• payload.id - Integer - The contact information ID to delete

Expected Response Schema

{
  "source_public_key": "community_public_key",
  "source_site": {
    "protocol": "https",
    "fqdn": "arkipel.example.com"
  },
  "created_at": "2025-11-13T20:52:49Z",
  "signature": "...",
  "payload": {
    "type": "contact_information:delete",
    "message_id": "abc123def456"
  }
}

Async Processing

This is an asynchronous mutation. Use arkipel_messages:query with the returned message_id to check deletion status.

Timeline

Expected implementation: Q2 2025

Get Notified

Want to know when this feature launches? Contact us at devkit@arkipel.co

Related Messages (Available Now)

• people:upsert - Create/update people with nested contact information
• households:upsert - Create/update households with contact information
• organizations:upsert - Create/update organizations with contact information
• person:delete - Delete a person (deletes associated contacts)
• household:delete - Delete a household
• organization:delete - Delete an organization

Contact Types Supported

Contact information records support these types:

• Email - Email addresses
• PhoneNumber - Landline phone numbers
• CellNumber - Mobile phone numbers
• Fax - Fax numbers
• Website - URLs and web links
• SocialMedia - Social media handles
• Other - Custom contact methods

Important Notes

• No undo: Deleted contact information cannot be recovered
• Main contact protection: Cannot delete the only/main contact without replacing it
• Marketing consent: Deleting an email doesn’t affect marketing consent status

Use Cases

• Contact Updates: Remove old email addresses or phone numbers
• Privacy Compliance: Delete contact info per GDPR/data deletion requests
• Data Quality: Remove invalid or duplicate contact records

---

Return to API Specifications