Create a Humantic AI profile for one person.
One of linkedin_url / email / text; optional first_name / last_name / company_name hints.
POST /v1/user-profile/create
humantic_pi_profile_create_v1({ "linkedin_url": "https://linkedin.com/in/sarah-chen-vp" })
// Profile already exists → served straight back
{
"status": "200",
"message": "Success",
"results": {
"display_name": "Sarah Chen",
"user_description": "VP Operations at Acme Corp",
"location": "Austin, Texas, United States",
"personality_analysis": {
"disc_assessment": {
"dominance": { "score": 7.8, "level": "high" },
"influence": { "score": 4.1, "level": "medium" },
"steadiness": { "score": 2.8, "level": "low" },
"calculativeness": { "score": 8.9, "level": "high" }
},
"ocean_assessment": { "conscientiousness": { "score": 7.9, "level": "Conscientious" }, "openness": { "score": 6.2, "level": "Somewhat Open" } },
"summary": { "disc": { "label": ["D", "C"], "description": ["High Dominance", "High Calculativeness"], "color": "red", "group": "dominant", "archetype": "Strategist" } }
},
"persona": { "sales": { "communication_advice": {
"adjectives": ["Direct", "Analytical", "Results-Driven"],
"key_traits": { "Speed": "Decides fast once the numbers hold up.", "Decision Drivers": "Evidence, ROI, and low execution risk." },
"what_to_say": ["Lead with hard numbers and a clear ROI case", "Be brief; get to the point in the first line"],
"what_to_avoid": ["Small talk before the substance", "Vague claims without proof points"]
} } }
},
"metadata": { "confidence": { "score": 92, "level": "High Confidence" }, "status": "FOUND", "status_code": 1, "analysis_status": "COMPLETE", "linkedin_analysis_status": "COMPLETED", "analysis_type": "linkedin" },
"_status": "ready",
"_trace_id": "7383c1abdacbf400",
"_quota": { "pool": "api", "limit": 3000, "consumed": 412, "remaining": 2588 }
}
// New person → analysis kicks off; call profile_fetch after 30–45 seconds
{
"status": "200",
"message": "Success",
"metadata": { "status": "FOUND", "status_code": 1, "analysis_status": "IN_PROGRESS", "linkedin_analysis_status": "PENDING", "analysis_type": "linkedin" },
"_status": "processing",
"_trace_id": "a1c9e4d27b60f3e5",
"_quota": { "pool": "api", "limit": 3000, "consumed": 413, "remaining": 2587 }
}
// Unknown or private LinkedIn URL → no analysis
{
"status": "200",
"message": "Success",
"metadata": { "status": "NOT_FOUND", "status_code": 41, "analysis_status": "NOT_FOUND", "linkedin_analysis_status": "INVALID_URL", "analysis_type": "linkedin" },
"_status": "ready",
"_trace_id": "84a4ac0e0b02dfab"
}
_status: "ready"). If not, the analysis starts and the response comes back _status: "processing" — call profile_fetch after 30–45 seconds to pick up the finished profile. An unknown or private LinkedIn URL returns metadata.status: "NOT_FOUND". If confidence comes back low, follow up with profile_update with something the person wrote.