Skip to main content
Dripcel logo
  • Category: marketing automation
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 18
  • Triggers: 0
  • Slug: DRIPCEL
  • Version: 20261101_00

Tools

Slug: DRIPCEL_CREATE_CONTACTSTool to upload a list of new contacts to Dripcel in bulk. Only creates new contacts (does not update existing ones). Use when you need to add multiple contacts to your Dripcel account at once. Maximum 100,000 contacts per request.

Input Parameters

object
Optional send object to trigger a message send upon contact upload.
string ("ZA" | "NA")
Country code for parsing cell numbers. Use ‘ZA’ for South Africa or ‘NA’ for Namibia.
array
Array of tag IDs to apply to all uploaded contacts. Use GET /tags to retrieve valid tag IDs.
array
required
Array of contact objects to upload. Maximum 100,000 contacts per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_DELETE_CONTACTTool to delete a contact by their cell number. Use when you need to remove a contact from Dripcel after confirming the MSISDN.

Input Parameters

string
required
The MSISDN (E.164 formatted) of the contact to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_DELETE_TAGTool to delete a tag by its ID. Use when you need to remove a tag from Dripcel. Warning: This will also remove the tag from all contacts and campaigns that have it.

Input Parameters

string
required
The ID of the tag to delete. This will also remove the tag from all contacts and campaigns that have it.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_BALANCERetrieves the current credit balance for your Dripcel organization account. This action requires no input parameters and returns the available credit balance as a numeric value. Use this to check your account balance before performing credit-consuming operations like sending SMS messages. The balance is returned in your account’s default currency (not explicitly specified in the response).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_CAMPAIGNSRetrieves a list of campaigns from Dripcel. Supports optional pagination (page, pageSize) and filtering by campaign status. Returns campaign details including ID, name, status, and timestamps.

Input Parameters

integer
Page number for pagination, must be >=1
string
Filter campaigns by status (e.g., ‘active’, ‘paused’, ‘completed’)
integer
Number of items per page, must be >=1

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_CONTACTTool to retrieve a single contact by their cell number (MSISDN). Use when you need to view details of a specific contact including their name, email, tags, and other metadata.

Input Parameters

string
required
The MSISDN (phone number) of the contact to retrieve. Can be in E.164 format (+15555551234) or without the plus sign (15555551234).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_DELIVERIESTool to retrieve SMS/email delivery records from Dripcel. Returns a list of message deliveries filtered by recipient phone number (cell) or send operation ID (customerId). Useful for tracking message delivery status, checking delivery history for a specific contact, or auditing a particular send operation.

Input Parameters

string
The MSISDN of the contact to query deliveries for
string
The unique ID of a particular send to query deliveries for (24-character hex string, MongoDB ObjectId format)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_EMAIL_TEMPLATESRetrieves all email templates from your Dripcel account. Returns a list of templates with their IDs, names, subjects, and content. Use this action when you need to: - View all available email templates in your account - Get template IDs for use in email sending operations - Check template content before selecting one for a campaign - List templates to verify template creation or updates Note: According to API documentation, this endpoint returns all templates without documented support for pagination or filtering.

Input Parameters

integer
Page number for pagination (undocumented parameter, support not guaranteed).
string
Field name to sort results by, such as ‘created_at’ or ‘name’ (undocumented parameter, support not guaranteed).
integer
Maximum number of templates to return per page (undocumented parameter, support not guaranteed).
string ("asc" | "desc")
Sort order: ‘asc’ for ascending or ‘desc’ for descending (undocumented parameter, support not guaranteed).
Search term to filter templates by name or content (undocumented parameter, support not guaranteed).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_GET_SALESRetrieve sales records for reporting or analytics. Returned records contain campaign ID, cell, sale date and sale value; other provider fields are not returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_LIST_TAGSTool to retrieve all tags in your Dripcel organization. Use when you need to view available tags, get tag IDs for adding to contacts, or verify tag existence before operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_OPT_OUT_CONTACTTool to opt out a contact from multiple campaigns at once. Use when you need to remove a contact from campaign messaging. More robust than single campaign opt-out, allowing batch operations or opting out from all campaigns at once.

Input Parameters

boolean
If true, opt out the contact from all existing and future campaigns. Takes precedence over campaign_ids.
string
required
The MSISDN (E.164 formatted phone number) of the contact to opt out.
array
List of campaign IDs to opt out from. If not provided and ‘all’ is false, no campaigns will be opted out.
boolean
If true, create the contact if it doesn’t exist before opting out.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_POST_COMPLIANCE_SENDCheck if phone numbers are allowed to receive SMS messages based on opt-out status and campaign targeting rules. Returns whether each number can be sent to, helping ensure compliance before sending messages. Costs 0.14 credits per phone number checked.

Input Parameters

array
required
List of phone numbers to verify compliance for. For South Africa (ZA), numbers must start with ‘0’ or ‘27’ followed by up to 9 digits.
string
required
ISO 3166-1 alpha-2 country code of the phone numbers (e.g., ‘ZA’ for South Africa).
string
Campaign ID (24-character hex ObjectId) to check phone numbers against campaign-specific targeting criteria. If omitted, only global opt-outs will be checked.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_POST_REPLIES_SEARCHSearch for SMS/message replies with flexible filtering by ID, campaign, phone number, reply type, message content, or date range. Returns matching replies with metadata. All filters are optional and can be combined for precise queries.

Input Parameters

string
Reply ID(s) to filter. Must be 24-character hex ObjectID(s). Use single ID or list for OR matching.
string
Reply type(s): optIn, optOut, or unknown.
string
Sender phone number(s) in full international format (e.g., +1234567890).
string
Content of the reply message.
object
Date-range filter for when the reply was received.
string
Campaign ID(s) that triggered the reply. Must be 24-character hex ObjectID(s).
string
ID(s) of the send(s) being replied to. Must be 24-character hex ObjectID(s).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_PUT_CONTACT_TAG_ADDAdd one or more tags to a contact identified by phone number. Use this tool to organize contacts by assigning tags for segmentation and targeting. Tags must exist in the system before being added - use GET /tags to retrieve valid tag IDs. Provide either tag_ids (recommended) or tag names. Set create_missing_contact=true to automatically create the contact if they don’t exist in your Dripcel account. Response includes matchedCount (contacts found) and modifiedCount (contacts updated).

Input Parameters

string
required
Phone number of the contact in E.164 international format (e.g., +15551234567). Must include country code with + prefix.
array
List of tag names to add to the contact. Tag names are less stable than IDs as they can be renamed. Must provide either tag_ids or tags.
array
List of tag IDs to add to the contact. Use GET /tags to retrieve valid tag IDs. Must provide either tag_ids or tags (tag_ids preferred).
boolean
If true, automatically creates the contact if it doesn’t exist. If false, operation only succeeds if contact exists (matchedCount will be 0 if contact not found).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_SEARCH_SEND_LOGSSearch for SMS send logs by ID, campaign, or delivery start date range. Supports MongoDB-style filters, projection, and pagination; filters are optional and can be combined.

Input Parameters

object
MongoDB-style query filter for send logs.
object
Pagination options for result set.
object
Fields to return in results. Use {field: 1} syntax.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_SEND_BULK_EMAILTool to send bulk emails to multiple recipients using a template. Use when you need to send the same email content to many contacts at once.

Input Parameters

string
required
The email address to send from.
string
required
The _id of the email template to use for the bulk send.
string
Schedule to send for a future time. Default is to send immediately.
array
required
List of recipient email addresses to send to.
boolean
Filter out email addresses that aren’t in your Dripcel contacts. Required if the template contains custom fields to replace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_SEND_SMSTool to send a single SMS to a contact. Use when you need to deliver a targeted message immediately or schedule it for later.

Input Parameters

string
required
Recipient’s phone number in international E.164 format.
string ("plain" | "unicode")
SMS encoding type. Use ‘unicode’ if message contains non-GSM characters.
string
required
Sender ID or phone number (alphanumeric up to 11 chars or E.164 format).
string ("ZA" | "NA" | "GB" | "AU" | "IE" | "IT" | "US")
required
Country code for SMS delivery.
string
required
SMS text content, up to 1600 characters.
string
Optional scheduled send time in ‘YYYY-MM-DD HH:MM’ (24-hour) format.
string
Optional campaign ID to associate the send.
string ("reverse" | "standard" | "transactional")
Delivery method to use for the SMS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: DRIPCEL_UPSERT_CONTACTSUpload contacts in bulk to Dripcel, creating new contacts or updating existing ones to import or sync a list. Each request accepts up to 20,000 contacts, and the result reports contacts that failed validation.

Input Parameters

object
Configuration for triggering a send to contacts after upload.
string ("ZA" | "NA")
Country code for parsing cell numbers. Use when contacts don’t have country codes in their numbers.
array
List of tag IDs to apply to ALL contacts in this upload. Individual contact tag_ids will be merged with these.
array
required
Array of contact objects to upload. Limit: 20,000 contacts per request. Each contact requires at minimum a cell number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not