Solved

didn’t find many campaigns properties in the date-versioned API

  • 17 March 2023
  • 4 replies
  • 66 views

Badge +2

Hi there,

We’re migrating our integration with Klaviyo from v1 to the date-versioned API. Now I research stable version ‘2023-02-22’.

Getting data from the endpoint /api/campaigns/, I didn’t find many campaigns properties such as:

campaign_type
object
subject
from_email
from_name
num_recipients

Please advise where I can get these properties.

Thanks in advance!

Regards,

Evgeniy

icon

Best answer by Brian Turcotte 20 March 2023, 21:17

View original

4 replies

Badge +2

Hi Brian,

Thank you for the info provided!

I’ve managed to get mentioned fields.

Kind regards,

Evgeniy

Userlevel 7
Badge +36

Hi @imp_dev!

 

May I ask what information you are receiving from the new endpoints, if any? Let me check on this with Engineering for you and I’ll get back to the thread ASAP on the expected behavior of this endpoint. 

 

Thanks,

Brian

Badge +2

Hi Brian,

Thank you for looking here!

For example, I’ve got the following data for one of campaigns:

curl -L -X GET 'https://a.klaviyo.com/api/campaigns/01GV3PM3H0984SCV55V5DMF67W' \
-H 'Authorization: Klaviyo-API-Key {{api_key}}' \
-H 'revision: 2023-02-22' \
-H 'Accept: application/json'

response:

{
    "data": {
        "type": "campaign",
        "id": "01GV3PM3H0984SCV55V5DMF67W",
        "attributes": {
            "name": "B456-075106 - c1 - EXTERNAL - 2023 March Email - Turkey Tuesday - Turkey Vest - 3/14/23",
            "status": "Sent",
            "archived": false,
            "channel": "email",
            "audiences": {
                "included": [
                    "W5ykDG"
                ],
                "excluded": []
            },
            "send_options": {
                "use_smart_sending": false,
                "ignore_unsubscribes": false
            },
            "message": "01GV3PM3KS7Z20SZRZ17P1Q948",
            "tracking_options": {
                "is_tracking_opens": true,
                "is_tracking_clicks": true,
                "is_add_utm": false,
                "utm_params": []
            },
            "send_strategy": {
                "method": "ab_test_campaign",
                "options_static": null,
                "options_throttled": null,
                "options_sto": null
            },
            "created_at": "2023-03-09T17:27:41.857059+00:00",
            "scheduled_at": "2023-03-13T16:10:52.583002+00:00",
            "updated_at": "2023-03-14T21:45:07.437708+00:00",
            "send_time": "2023-03-14T21:00:00+00:00"
        },
        "links": {
            "self": "https://a.klaviyo.com/api/campaigns/01GV3PM3H0984SCV55V5DMF67W/"
        }
    }
}

 

However, in v1 API we had another set of properties for the same campaign:

curl -L -X GET 'https://a.klaviyo.com/api/v1/campaign/01GV3PM3H0984SCV55V5DMF67W?api_key={{api_key}}'

{
    "object": "campaign",
    "id": "01GV3PM3H0984SCV55V5DMF67W",
    "subject": "Featured Product: Turkey Vest With Optional Bino Connect Kit",
    "from_email": "info@badlandspacks.com",
    "from_name": "Badlands",
    "sent_at": "2023-03-14 21:45:07",
    "send_time": "2023-03-14 21:00:00",
    "name": "B456-075106 - c1 - EXTERNAL - 2023 March Email - Turkey Tuesday - Turkey Vest - 3/14/23",
    "lists": [
        {
            "object": "list",
            "id": "W5ykDG",
            "name": "Profiles_huntspecies_turkey",
            "list_type": "segment",
            "folder": null,
            "created": "2023-03-09 17:21:07",
            "updated": "2023-03-09 17:26:31",
            "person_count": 37134
        }
    ],
    "excluded_lists": [],
    "status": "sent",
    "status_id": 1,
    "status_label": "Sent",
    "created": "2023-03-09 17:27:41",
    "updated": "2023-03-14 21:45:07",
    "num_recipients": 31234,
    "campaign_type": "A/B Send Time",
    "is_segmented": true,
    "message_type": "email",
    "template": {
        "object": "email-template",
        "id": "S3bxFP",
        "html": "«...CUT OUT...>>"

    }

}

 

So, I can’t find the following campaign properties in the new API:

campaign_type
object
subject
from_email
from_name
num_recipients

Userlevel 7
Badge +36

Hi @imp_dev!

 

So I spoke with Engineering, and it turns out that all of this information is still available via API - you may just have to call multiple different endpoints such as GET Campaign + Get Campaign Message + Get Campaign Recipient Estimation, whereas previously this may have all been provided through one endpoint.

 

This restructuring will enable us to add some expanded functionality to each endpoint that the UI has that hasn't been possible to do in the API before.

 

I hope this helps to clarify!

- Brian

Reply