ac_get_deals {ractivecampaign}

Retrieve all existing deals

Description

Retrieve all existing deals

Usage

ac_get_deals(
  search = NULL,
  search_field = NULL,
  title = NULL,
  stage = NULL,
  group = NULL,
  status = NULL,
  owner = NULL,
  nextdate_range = NULL,
  tag = NULL,
  tasktype = NULL,
  created_before = NULL,
  created_after = NULL,
  updated_before = NULL,
  updated_after = NULL,
  organization = NULL,
  minimum_value = NULL,
  maximum_value = NULL,
  score_greater_than = NULL,
  score_less_than = NULL,
  score = NULL
)

Arguments

search

Search text to use with search_field parameter.

search_field

Field to search for. Available values: all (All three fields: title, contact, and org), title (Deal's title), contact (Deal's primary contact's first name and last name. If search parameter has more than one word, first word is used for matching first name of contacts and rest of the words are used for matching last name of contacts.), org (Deal's primary contact's organization name).

title

Filter by deal's title

stage

Filter by deal's stage

group

Filter by deal's pipeline

status

Filter by deal's status. 0 - Open, 1 - Won, 2 - Lose.

owner

Filter by deal's owner

nextdate_range

Filter by deal's tasks due dates. Available values: upcoming (Deals with tasks that are due within 24 hours.), scheduled (Deals with tasks that are due in more than 24 hours), overdue (Deals with tasks that are past due dates.), no-task (Deals without any task.).

tag

Filter by tag names associated with deal's primary contact. Available values: greater than 0 (Deals with primary contacts that have the tag with given id), -1 (Deals with primary contacts that have any tag), -2 (Deals with primary contacts that have no tag)

tasktype

Filter by deals that have tasks with given type

created_before

Returns deals that are created less than given date

created_after

Returns deals that are created greater than or equal to given date

updated_before

Returns deals that are updated less than given date

updated_after

Returns deals that are updated greater than or equal to given date

organization

Filter by deal's primary contact's organization's id

minimum_value

In USD with dollar portion. Returns deals whose values are greater than or equal to given

maximum_value

In USD with dollar portion. Returns deals whose values are less than or equal to given

score_greater_than

In a format of <score_id>:<score_value>. Returns deals whose score value is greater than given value

score_less_than

In a format of <score_id>:<score_value>. Returns deals whose score value is less than given value

score

In a format of <score_id>:<score_value>. Returns deals whose score value is equal to given value

Value

tibble with deals data

See Also

Deals

Examples

## Not run: 
Sys.setenv('ACTIVECAMPAGN_API_TOKEN' = "YOUR_TOKEN")
Sys.setenv('ACTIVECAMPAGN_API_URL' = "https://<your-account>.api-us1.com")

deals <- ac_get_deals()

## End(Not run)