Assign Activity via API

[bpmccain]

Anyone have any idea how you assign an activity via the API, so that the contact who the activity is assigned to receives an e-mail in the same way that they do when using the GUI?

Brian

[totten]

The main "Activity" API includes some under-documented params to manipulate the relationship between the contact and activity. For example, this creates a new activity with various contacts:

https://github.com/civicrm/civihr/blob/e3047e251e60c1df3cfb6c5face390555ff6dc2a/hrabsence/CRM/HRAbsence/Form/AbsenceRequest.php#L454

I believe there are parallel "return" options (eg "return.assignee_contact_id" => 1) for use when fetching activities.

As far as how that ties into emails... I'm not sure which email you're referring to. Could be:
 * If you've configured scheduled reminders for activities, then they'll work the same regardless of how one creates/edits the activity.
 * If you're using CiviCase and its built-in notifications, then I don't know the answer off the top of my head.
 * If you're trying to create activities of type "Email" which are then sent out, then I don't think there's an API, but there's a function to create the activity and send the message at once (CRM_Activity_BAO_Activity::sendEmail). One could probably write a new API (wrapping around that function) without too much difficulty.

[bpmccain]

The email I am referring to is on any Activity screen. Click on New Activity, and there is an Assigned To line. You can type in a contact name there, and when you save the activity, that contact receives an e-mail notification of the Activity.

I'll look into the link you gave.

[bpmccain]

I'm able to assign an Activity to a contact using the API, but unfortunately this doesn't result in the system generated e-mail that is sent when assigning an Activity to a contact using the GUI. Is there anyway to do that?

I'd prefer to have the activity in an e-mail than have to use a hook to send a link to the activity, which would require a user login for a mobile device etc.

Brian

[capo]

I'm able to assign an Activity to a contact using the API, but unfortunately this doesn't result in the system generated e-mail that is sent when assigning an Activity to a contact using the GUI. Is there anyway to do that?

Not sure if that will help you but maybe you can sue scheduled reminders to trigger the email after assigning the activity.

[capo]

By the way, since 4.5 you'll have the ActivityContact API entity, too (CRM-14414), so you'll have a second way to assign activities. (I guess the email won't probably be sent either, anyway).

[Eileen]

If we wind up doing an LTS on 4.4 I'm sure that will go into the LTS too