Clean Contact

PUT 
/audiences/clean-contact

Clean Contact

Cleans a specific contact's email address based on its quality score (ranging from 1 to 10):

• 6-10: Mark as Subscribed (high-quality email)
• 1-5: Mark as Inactive (low-quality email)

If email address already present in the system, it will be updated based on the quality score. If not present, it will be added to the system with the appropriate status. We create one audience list named Cleanup Contact List and add the contact to this list. If the list is not present, we will create it.

Request

application/json

Body

required

email stringrequired

Responses

200

Successful operation

application/json

Schema

Schema

email string
score number
status string
recommendation string
rating string
domain string
provider string

Example (from schema)

{
  "email": "test@tinyemail.com",
  "score": 6,
  "status": "possibly_deliverable",
  "recommendation": "send_with_caution",
  "rating": "fair",
  "domain": "tinyemail.com",
  "provider": "Other"
}

400

Bad Request

application/json

Schema

Schema

message string

Example (from schema)

{
  "message": "Some error message"
}

401

API key is missing or invalid

402

Payment Required

application/json

Schema

Schema

message string

Example (from schema)

{
  "message": "Insufficient credits. Current balance: X, required: Y, deficit: Z"
}

405

Method Not Allowed

Loading...