# Archive a Contact

DELETE https://api.smobi.com/v1/contacts/{identifier}

Authentication: x-api-key header (brand-scoped API key).

Archives the contact (soft delete): it is hidden from lists, excluded from campaign sends and segment syncs, and can be restored with PATCH {"active": true}. Idempotent — archiving an archived contact returns 204. Personal data can be cleared beforehand by PATCHing fields to null.

## Operation

```json
{
  "description": "Archives the contact (soft delete): it is hidden from lists, excluded from campaign sends and segment syncs, and can be restored with PATCH {\"active\": true}. Idempotent — archiving an archived contact returns 204. Personal data can be cleared beforehand by PATCHing fields to null.",
  "operationId": "archiveContact",
  "parameters": [
    {
      "name": "identifier",
      "required": true,
      "in": "path",
      "description": "Contact id (uuid) or phone number (digits-only recommended in URLs; E.164 requires encoding + as %2B)",
      "schema": {
        "example": "14155552222",
        "type": "string"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Contact archived"
    },
    "400": {
      "description": "Identifier is neither a uuid nor a phone number"
    },
    "401": {
      "description": "Missing or invalid API key",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "statusCode": {
                "type": "number",
                "example": 401
              },
              "message": {
                "type": "string",
                "example": "Invalid API key"
              },
              "error": {
                "type": "string",
                "example": "Unauthorized"
              }
            }
          }
        }
      }
    },
    "403": {
      "description": "The API key is not scoped to a brand",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "statusCode": {
                "type": "number",
                "example": 403
              },
              "message": {
                "type": "string",
                "example": "This endpoint requires a brand-scoped API key"
              },
              "error": {
                "type": "string",
                "example": "Forbidden"
              }
            }
          }
        }
      }
    },
    "404": {
      "description": "No contact with this id or phone number exists for the brand",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "statusCode": {
                "type": "number",
                "example": 404
              },
              "message": {
                "type": "string",
                "example": "Contact not found"
              },
              "error": {
                "type": "string",
                "example": "Not Found"
              }
            }
          }
        }
      }
    }
  },
  "summary": "Archive a Contact",
  "tags": [
    "Contacts"
  ],
  "security": [
    {
      "x-api-key": []
    }
  ]
}
```

## Referenced Schemas

```json
{}
```