Used to calculate the number of contacts for an Acoustic Campaign query. The CalculateQuery data job calculates a particular query only if the query size was not calculated in the last 12 hours. You can programmatically obtain the status for the data job through the GetJobStatus call, or you can trigger an email notification.
Elements (Required)
QUERY_ID - The ID of the query to be calculated.
<Envelope>
<Body>
<CalculateQuery>
<QUERY_ID>59294</QUERY_ID>
</CalculateQuery>
</Body>
</Envelope>
<Envelope>
<Body>
<RESULT>
<SUCCESS>TRUE</SUCCESS>
<JOB_ID>499600</JOB_ID>
</RESULT>
</Body>
</Envelope>
Elements (Response)
SUCCESS - True if successful; False if not.
JOB_ID - Identifies the Acoustic Campaign background job created and scheduled for this export.
Get email notifcation
You can trigger an email notification to be sent when the data job for the query is completed by adding the EMAIL_NOTIFICATION
element to the API call.
EMAIL_NOTIFICATION - Provide your email ID to which the notification will be sent.
Example request call with the email parameter:
<Envelope>
<Body>
<CalculateQuery>
<QUERY_ID>5435057</QUERY_ID>
<EMAIL_NOTIFICATION>your email address</EMAIL_NOTIFICATION>
</CalculateQuery>
</Body>
</Envelope>
An email notification will be sent to the provided email with a success or failure message when the query data job completes.