Simple API question: How/Where do I get the API key?
I've set up an API admin group and given it the needed permissions, per the instructions I somehow managed to get hold of. But while they refer to the CONVIO_API_KEY requirement, they don't tell me how to get it. Seems simple enough, but I've yet to find an answer. Can someone help?
Also, can I just say how massively frustrating it has been trying to find basic information like this? I have found any number of abstract overview descriptions of the API and what you can do with it, plus several detailed discussions among people who are already using it, but VERY few step-by-step instructions on *getting* started and what I have found--such as the one above--don't contain all the information I need or any links to get it. I don't see why this has to be so difficult!
Comments
-
Sorry you've had trouble finding API information. Definitely don't hesitate to post messages in the community or contact support or your Account Manager when you're having problems!
By the details in what you've shared already, I gather you've already found the documentation a
http://customer.convio.com/site/PageServer?pagename=Help_Admin_ConvioAPIs_SiteConfig
That goes over the basic setup required to use the APIs.
The CONVIO_API_KEY is a site parameter that is entered in the Convio Admin site. Go to Setup...Site Options. Where it says: "Select Property Type To View:" choose: "Convio API" and click Go. Then you will see the CONVIO_API_KEY. This key can be anything you'd like. It will be passed via the API to improve the security of proving the the call is being made from a site with permissions to call data from your site.
Hope this helps. Please don't hesitate to reply if you're having other problems or we can get you more info!
Corey
0 -
Corey Pudhorodsky:
Sorry you've had trouble finding API information. Definitely don't hesitate to post messages in the community or contact support or your Account Manager when you're having problems!
By the details in what you've shared already, I gather you've already found the documentation a
http://customer.convio.com/site/PageServer?pagename=Help_Admin_ConvioAPIs_SiteConfig
That goes over the basic setup required to use the APIs.
The CONVIO_API_KEY is a site parameter that is entered in the Convio Admin site. Go to Setup...Site Options. Where it says: "Select Property Type To View:" choose: "Convio API" and click Go. Then you will see the CONVIO_API_KEY. This key can be anything you'd like. It will be passed via the API to improve the security of proving the the call is being made from a site with permissions to call data from your site.
Hope this helps. Please don't hesitate to reply if you're having other problems or we can get you more info!
Corey
Thanks Corey--exactly the information I was hunting for! Let's change that smiley to a
We're developing a complex interactive application part of which is a simple registration form that we'd like to have capture data into Convio--just a name, email address and a specific interest group category that we can later use to contact people who have used the application. I'm familiar with the theory of API's but I haven't actually tried to use one before, so I'm hoping this is a farily straightforward exercise to get my feet wet in this stuff. One complication would be that some of the users may already be in our Constituent db, so I need to be able to alter a profile to add this interest group in the same operation. Looks like the createOrUpdate method will do that...?
Anyway, I seem to recall finding an example of the kind of thing here in the Community, so I'm poking around for that. If you know of a good posting or tutorial along these lines I'd love to know about it.
Thanks again.
0 -
Bill Bennett:
Thanks Corey--exactly the information I was hunting for! Let's change that smiley to a
We're developing a complex interactive application part of which is a simple registration form that we'd like to have capture data into Convio--just a name, email address and a specific interest group category that we can later use to contact people who have used the application. I'm familiar with the theory of API's but I haven't actually tried to use one before, so I'm hoping this is a farily straightforward exercise to get my feet wet in this stuff. One complication would be that some of the users may already be in our Constituent db, so I need to be able to alter a profile to add this interest group in the same operation. Looks like the createOrUpdate method will do that...?
Anyway, I seem to recall finding an example of the kind of thing here in the Community, so I'm poking around for that. If you know of a good posting or tutorial along these lines I'd love to know about it.
Thanks again.
You might find the following example and documentation helpful:
http://open.convio.com/api/constituent-api/client/code/two-step-registration.html
Note that this example assumes that the form is hosted on a Convio page so the Authentication token can be passed. This is the trickiest part as the user needs to be logged in or the authentication token granted via the SSO API in order to complete updates of existing constituent records.
Good luck and keep us posted of your progress!
0 -
You make a great point, and while I can't resolve it all today, I am working to improve the documentation and the ease of finding information within the Open Community. All feedback is welcome.
0 -
Bill Bennett:
Thanks Corey--exactly the information I was hunting for! Let's change that smiley to a
We're developing a complex interactive application part of which is a simple registration form that we'd like to have capture data into Convio--just a name, email address and a specific interest group category that we can later use to contact people who have used the application. I'm familiar with the theory of API's but I haven't actually tried to use one before, so I'm hoping this is a farily straightforward exercise to get my feet wet in this stuff. One complication would be that some of the users may already be in our Constituent db, so I need to be able to alter a profile to add this interest group in the same operation. Looks like the createOrUpdate method will do that...?
Anyway, I seem to recall finding an example of the kind of thing here in the Community, so I'm poking around for that. If you know of a good posting or tutorial along these lines I'd love to know about it.
Thanks again.
For the two-step example it looks like I'll need to set up a new page wrapper with the requisite javascript in the <head> tag? Because the PageBuilder itself doesn't give access to head elements, unless I'm missing something. Is that more or less SOP?
Ultimately I've got to figure out how to do this as a createOrUpdate from a non-Convio page, I'm pretty sure. It's going to live inside a Flash application on its own domain/website, and we don't want to drop visitors out of that user experience to do a log-in. Unless there's some way to make it appear seamless, which I don't see yet. And since some of the visitors may already have Convio accounts it can't be just a "create" function unless I'm missing something there too.
I did find this discussion thread, which looked promising: Creating a signup for an interest group on an outside webpage. That's exactly what we're trying to do, but I haven't managed to get the script snippet to work in our environment yet. I posted a comment there describing what I tried and the result so far.
Thanks for any help--feeling a little dense at this point.
0
Categories
- All Categories
- Shannon parent
- shannon 2
- shannon 1
- 21 Advocacy DC Users Group
- 14 BBCRM PAG Discussions
- 89 High Education Program Advisory Group (HE PAG)
- 28 Luminate CRM DC Users Group
- 8 DC Luminate CRM Users Group
- Luminate PAG
- 5.9K Blackbaud Altru®
- 58 Blackbaud Award Management™ and Blackbaud Stewardship Management™
- 409 bbcon®
- 2.1K Blackbaud CRM™ and Blackbaud Internet Solutions™
- donorCentrics®
- 1.1K Blackbaud eTapestry®
- 2.8K Blackbaud Financial Edge NXT®
- 1.1K Blackbaud Grantmaking™
- 527 Education Management Solutions for Higher Education
- 1 JustGiving® from Blackbaud®
- 4.6K Education Management Solutions for K-12 Schools
- Blackbaud Luminate Online & Blackbaud TeamRaiser
- 16.4K Blackbaud Raiser's Edge NXT®
- 4.1K SKY Developer
- 547 ResearchPoint™
- 151 Blackbaud Tuition Management™
- 61 everydayhero
- 3 Campaign Ideas
- 58 General Discussion
- 115 Blackbaud ID
- 87 K-12 Blackbaud ID
- 6 Admin Console
- 949 Organizational Best Practices
- 353 The Tap (Just for Fun)
- 235 Blackbaud Community Feedback Forum
- 55 Admissions Event Management EAP
- 18 MobilePay Terminal + BBID Canada EAP
- 36 EAP for New Email Campaigns Experience in Blackbaud Luminate Online®
- 109 EAP for 360 Student Profile in Blackbaud Student Information System
- 41 EAP for Assessment Builder in Blackbaud Learning Management System™
- 9 Technical Preview for SKY API for Blackbaud CRM™ and Blackbaud Altru®
- 55 Community Advisory Group
- 46 Blackbaud Community Ideas
- 26 Blackbaud Community Challenges
- 7 Security Testing Forum
- 3 Blackbaud Staff Discussions
- 1 Blackbaud Partners Discussions
- 1 Blackbaud Giving Search™
- 35 EAP Student Assignment Details and Assignment Center
- 39 EAP Core - Roles and Tasks
- 59 Blackbaud Community All-Stars Discussions
- 20 Blackbaud Raiser's Edge NXT® Online Giving EAP
- Diocesan Blackbaud Raiser’s Edge NXT® User’s Group
- 2 Blackbaud Consultant’s Community
- 43 End of Term Grade Entry EAP
- 92 EAP for Query in Blackbaud Raiser's Edge NXT®
- 38 Standard Reports for Blackbaud Raiser's Edge NXT® EAP
- 12 Payments Assistant for Blackbaud Financial Edge NXT® EAP
- 6 Ask an All Star (Austen Brown)
- 8 Ask an All-Star Alex Wong (Blackbaud Raiser's Edge NXT®)
- 1 Ask an All-Star Alex Wong (Blackbaud Financial Edge NXT®)
- 6 Ask an All-Star (Christine Robertson)
- 21 Ask an Expert (Anthony Gallo)
- Blackbaud Francophone Group
- 22 Ask an Expert (David Springer)
- 4 Raiser's Edge NXT PowerUp Challenge #1 (Query)
- 6 Ask an All-Star Sunshine Reinken Watson and Carlene Johnson
- 4 Raiser's Edge NXT PowerUp Challenge: Events
- 14 Ask an All-Star (Elizabeth Johnson)
- 7 Ask an Expert (Stephen Churchill)
- 2025 ARCHIVED FORUM POSTS
- 322 ARCHIVED | Financial Edge® Tips and Tricks
- 164 ARCHIVED | Raiser's Edge® Blog
- 300 ARCHIVED | Raiser's Edge® Blog
- 441 ARCHIVED | Blackbaud Altru® Tips and Tricks
- 66 ARCHIVED | Blackbaud NetCommunity™ Blog
- 211 ARCHIVED | Blackbaud Target Analytics® Tips and Tricks
- 47 Blackbaud CRM Higher Ed Product Advisory Group (HE PAG)
- Luminate CRM DC Users Group
- 225 ARCHIVED | Blackbaud eTapestry® Tips and Tricks
- 1 Blackbaud eTapestry® Know How Blog
- 19 Blackbaud CRM Product Advisory Group (BBCRM PAG)
- 1 Blackbaud K-12 Education Solutions™ Blog
- 280 ARCHIVED | Mixed Community Announcements
- 3 ARCHIVED | Blackbaud Corporations™ & Blackbaud Foundations™ Hosting Status
- 1 npEngage
- 24 ARCHIVED | K-12 Announcements
- 15 ARCHIVED | FIMS Host*Net Hosting Status
- 23 ARCHIVED | Blackbaud Outcomes & Online Applications (IGAM) Hosting Status
- 22 ARCHIVED | Blackbaud DonorCentral Hosting Status
- 14 ARCHIVED | Blackbaud Grantmaking™ UK Hosting Status
- 117 ARCHIVED | Blackbaud CRM™ and Blackbaud Internet Solutions™ Announcements
- 50 Blackbaud NetCommunity™ Blog
- 169 ARCHIVED | Blackbaud Grantmaking™ Tips and Tricks
- Advocacy DC Users Group
- 718 Community News
- Blackbaud Altru® Hosting Status
- 104 ARCHIVED | Member Spotlight
- 145 ARCHIVED | Hosting Blog
- 149 JustGiving® from Blackbaud® Blog
- 97 ARCHIVED | bbcon® Blogs
- 19 ARCHIVED | Blackbaud Luminate CRM™ Announcements
- 161 Luminate Advocacy News
- 187 Organizational Best Practices Blog
- 67 everydayhero Blog
- 52 Blackbaud SKY® Reporting Announcements
- 17 ARCHIVED | Blackbaud SKY® Reporting for K-12 Announcements
- 3 Luminate Online Product Advisory Group (LO PAG)
- 81 ARCHIVED | JustGiving® from Blackbaud® Tips and Tricks
- 1 ARCHIVED | K-12 Conference Blog
- Blackbaud Church Management™ Announcements
- ARCHIVED | Blackbaud Award Management™ and Blackbaud Stewardship Management™ Announcements
- 1 Blackbaud Peer-to-Peer Fundraising™, Powered by JustGiving® Blogs
- 39 Tips, Tricks, and Timesavers!
- 56 Blackbaud Church Management™ Resources
- 154 Blackbaud Church Management™ Announcements
- 1 ARCHIVED | Blackbaud Church Management™ Tips and Tricks
- 11 ARCHIVED | Blackbaud Higher Education Solutions™ Announcements
- 7 ARCHIVED | Blackbaud Guided Fundraising™ Blog
- 2 Blackbaud Fundraiser Performance Management™ Blog
- 9 Foundations Events and Content
- 14 ARCHIVED | Blog Posts
- 2 ARCHIVED | Blackbaud FIMS™ Announcement and Tips
- 59 Blackbaud Partner Announcements
- 10 ARCHIVED | Blackbaud Impact Edge™ EAP Blogs
- 1 Community Help Blogs
- Diocesan Blackbaud Raiser’s Edge NXT® Users' Group
- Blackbaud Consultant’s Community
- Blackbaud Francophone Group
- 1 BLOG ARCHIVE CATEGORY
- Blackbaud Community™ Discussions
- 8.3K Blackbaud Luminate Online® & Blackbaud TeamRaiser® Discussions
- 5.7K Jobs Board