How to add a new and VALID Contact Type using the API?

API Q&A
,
1

I can update a contact’s Person Type/Contact Type in PHP just by passing a string like so:

$data = [
    'ContactType' => 'Customer Form',
];
return *****->request('ContactService.update', *****, $data );

However, it shows in the contact’s page as “Invalid”

Annotation 2020-01-22 143022

We can make this “valid” by adding that entry into the CRM settings page:

Annotation 2020-01-22 143022
Annotation 2020-01-22 143022860×276 23.4 KB

Now, since we can’t anticipate when the client would want new contact types, it would be best if the user can just add anytime he wants. So we should automate adding this new contact type in the CRM page.
Is there a way to do this using the API?

Tried using DataService.add and using table LinkedContactType. But it seems to fail.