ActivityTypes

ActivityTypes represent different kinds of activities that can be stored. Each ActivityType is presented to the user with an icon and a name. Additionally, a color can be defined (not implemented in the Pipedrive app as of today). ActivityTypes are linked to Activities via ActivityType.key_string = Activity.type. The key_string will be generated by the API based on the given name of the ActivityType upon creation, and cannot be changed. ActivityTypes should be presented to the user in an ordered manner, using the ActivityType.order_nr value.

Get all ActivityTypes

Copy link
Copy to clipboard
GET

/v1/activityTypes

Returns all ActivityTypes.

Response
200

A list of ActivityTypes

Expand all
Copy code
    • true
    • [ ... ]

    Add new ActivityType

    Copy link
    Copy to clipboard
    POST

    /v1/activityTypes

    Adds a new ActivityType and returns it upon success.

    Body parameters

    application/x-www-form-urlencoded

    name

    string

    required

    The name of the ActivityType

    icon_key

    string

    required

    Icon graphic to use for representing this activity type.

    Values

    task

    email

    meeting

    deadline

    call

    lunch

    calendar

    downarrow

    document

    smartphone

    camera

    scissors

    cogs

    bubble

    uparrow

    checkbox

    signpost

    shuffle

    addressbook

    linegraph

    picture

    car

    world

    search

    clip

    sound

    brush

    key

    padlock

    pricetag

    suitcase

    finish

    plane

    loop

    wifi

    truck

    cart

    bulb

    bell

    presentation

    color

    string

    A designated color for the ActivityType in 6-character HEX format (e.g. FFFFFF for white, 000000 for black)

    Response
    200

    The ActivityType was successfully created

    Expand all
    Copy code
      • true
      • { ... }

      Edit an ActivityType

      Copy link
      Copy to clipboard
      PUT

      /v1/activityTypes/{id}

      Updates an ActivityType.

      Path parameters

      id

      integer

      required

      The ID of the ActivityType

      Body parameters

      application/x-www-form-urlencoded

      name

      string

      The name of the ActivityType

      icon_key

      string

      Icon graphic to use for representing this activity type.

      Values

      task

      email

      meeting

      deadline

      call

      lunch

      calendar

      downarrow

      document

      smartphone

      camera

      scissors

      cogs

      bubble

      uparrow

      checkbox

      signpost

      shuffle

      addressbook

      linegraph

      picture

      car

      world

      search

      clip

      sound

      brush

      key

      padlock

      pricetag

      suitcase

      finish

      plane

      loop

      wifi

      truck

      cart

      bulb

      bell

      presentation

      color

      string

      A designated color for the ActivityType in 6-character HEX format (e.g. FFFFFF for white, 000000 for black)

      order_nr

      integer

      An order number for this ActivityType. Order numbers should be used to order the types in the ActivityType selections.

      Response
      200

      The ActivityType was successfully updated

      Expand all
      Copy code
        • true
        • { ... }

        Delete multiple ActivityTypes in bulk

        Copy link
        Copy to clipboard
        DELETE

        /v1/activityTypes

        Marks multiple ActivityTypes as deleted.

        Query parameters

        ids

        string

        required

        Comma-separated ActivityType IDs

        Response
        200

        The ActivityTypes were successfully deleted

        Expand all
        Copy code
          • true
          • { ... }

          Delete an ActivityType

          Copy link
          Copy to clipboard
          DELETE

          /v1/activityTypes/{id}

          Marks an ActivityType as deleted.

          Path parameters

          id

          integer

          required

          The ID of the ActivityType

          Response
          200

          The ActivityType was successfully deleted

          Expand all
          Copy code
            • true
            • { ... }

            Subscribe to Pipedrive’s Developer Newsletter