CiviCRM Community Forums (archive)

According to the documentation page, the function civicrm_contact_add should be used to add a contact. In the source of the API however, civicrm_contact_create is used. Is it not better to update the documentation and point new users to civicrm_contact_create? If so, I will change the documentation.
Erik

The civicrm_contact_add works fine, that is not the issue. But if you look in the code, all the civicrm_contact_add does is call the civicrm_contact_create:

function &civicrm_contact_add( &$params ) {
    _civicrm_initialize( );

    $contactID = CRM_Utils_Array::value( 'contact_id', $params );

    if ( !empty($contactID) ) {
        $result = civicrm_contact_update($params);
    } else {
        $result = civicrm_contact_create($params);
    }
    return $result;
}
This is according to the new standards for API (see this post: http://forum.civicrm.org/index.php/topic,15252.0.html). If we use the new standars, we should use the civicrm_contact_create. Even if the civicrm_contact_add still works (and should remain working so as to not force users to rewrite their code).
My point is that we need to update the documentation to advise the civicrm_contact_create (which I will do right now :-))
Erik